apache / apache/pekko-platform-guide

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

Open
#24 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
3
Forks
9
Avg merge
3h 34m
Merged PRs (30d)
1

Description

Relates to https://github.com/apache/incubator-pekko/issues/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.
```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.