Is this the website at pekko.apache.org or are you talking about the java doc and equivalent?
Do we have anybody who has expertise in documentation development? On Wed, Mar 1, 2023 at 12:08 PM Matthew Benedict de Detrich <matthew.dedetr...@aiven.io.invalid> wrote: > Previous discussion/s on this > > https://github.com/apache/incubator-pekko-site/pull/4 > https://lists.apache.org/thread/lzfkmq6k6y9t02y4o97jmcgnzxqcp4kh > > I think this would be a good time to discuss what software we should use to > generate our microsite at https://pekko.apache.org/ > > Suggestions that have already been made > > * Paradox: https://github.com/lightbend/paradox (we use this currently for > docs and there is a current setup for it, see previously mentioned PR) > * sbt-microsites: https://github.com/47degrees/sbt-microsites (uses Jekyll > under the hood but wraps it in sbt which is the same build tool that is > used for all of the other Pekko projects) > * https://github.com/planet42/Laika: Completely new design for microsites, > used somewhat in Scala projects. Also works with sbt > * https://infra.apache.org/asf-pelican.html Used by Apache projects > > I am personally leaning towards either Paradox or sbt-microsites. My > personal view on this is that while there are other technologies like > pelican which have historically been used with Apache, to me keeping the > number of tech stacks/build tools in the Pekko ecosystem has higher > priority and both of these projects use the exact same build tool that > Pekko libraries do. > > Ontop of this sbt-paradox is currently being used to generate our docs for > our various modules, although it does appear to be more catered for doc > generated than microsites (I don't know how significant the difference is > between the two). > -- > > Matthew de Detrich > > *Aiven Deutschland GmbH* > > Immanuelkirchstraße 26, 10405 Berlin > > Amtsgericht Charlottenburg, HRB 209739 B > > Geschäftsführer: Oskari Saarenmaa & Hannu Valtonen > > *m:* +491603708037 > > *w:* aiven.io *e:* matthew.dedetr...@aiven.io >
