We are talking about the host site which would be on pekko.apache.org, not the documentation, documentation is already handled with sbt-paradox. It's meant to be a nice landing page that will point to docs that are generated by sbt-paradox.
On Mon, Mar 20, 2023 at 2:58 PM Claude Warren, Jr <claude.war...@aiven.io.invalid> wrote: > 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 > > > -- 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
