Setup pekko-platform-guide to build with pekko-sbt-paradox

[sam-byng]

Relates to apache/pekko#244

See discussion on the mailing list:

PJ Fanning:
Any chance we could make the doc build use the pekko-sbt-paradox plugin like we use elsewhere?

Sambyng:
I think this is probably the ideal long term situation. I would say that we should do this now too.

I assume this will require the following - anything else?

- Docs conversion from asciidoc to markdown (potential bugs / features lost introduced during conversion)
Seems like there's a CLI tool for this here: https://github.com/opendevise/downdoc

- Update of codebase with a build.sbt file + paradox setup code / config etc.

- Update to use the pekko guide UI instead of the lightbend UI

- Strip out the current antora / asciidoctor code.

- Update the manual publishing guide: https://github.com/apache/incubator-pekko-site/wiki/Manual-Publishing

Pros: Consistent approach, Easily get the Apache Pekko UI in, Using a build tool that we control.
Cons: More work to get platform guide out. Bugs converting docs that will need ironing out.

[samueleresca]

I'm happy to give it a try here:

• Check what the cost of converting asciidoc into markdown
• Introducing a build.sbt that takes care of the documentation build similarly to https://github.com/apache/incubator-pekko/tree/main/docs/src

[samueleresca]

Replied back in the mailing list, see: [DISCUSS] Publishing and hosting the pekko-platform-guide