You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@pekko.apache.org by "sam-byng (via GitHub)" <gi...@apache.org> on 2023/04/28 17:38:26 UTC
[GitHub] [incubator-pekko-platform-guide] sam-byng opened a new issue, #24: Setup pekko-platform-guide to build with pekko-sbt-paradox
sam-byng opened a new issue, #24:
URL: https://github.com/apache/incubator-pekko-platform-guide/issues/24
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.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org
[GitHub] [incubator-pekko-platform-guide] samueleresca commented on issue #24: Setup pekko-platform-guide to build with pekko-sbt-paradox
Posted by "samueleresca (via GitHub)" <gi...@apache.org>.
samueleresca commented on issue #24:
URL: https://github.com/apache/incubator-pekko-platform-guide/issues/24#issuecomment-1534405689
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
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org
[GitHub] [incubator-pekko-platform-guide] samueleresca commented on issue #24: Setup pekko-platform-guide to build with pekko-sbt-paradox
Posted by "samueleresca (via GitHub)" <gi...@apache.org>.
samueleresca commented on issue #24:
URL: https://github.com/apache/incubator-pekko-platform-guide/issues/24#issuecomment-1536273806
Replied back in the mailing list, see: `[DISCUSS] Publishing and hosting the pekko-platform-guide`
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org