-
Notifications
You must be signed in to change notification settings - Fork 2.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add Asciidoc documentation generator #1390
base: main
Are you sure you want to change the base?
Conversation
Enda Phelan seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account. You have signed the CLA already but the status is still pending? Let us recheck it. |
This PR is being marked as stale due to a long period of inactivity |
I don't have an opinion on how valuable such an improvement would be compared to the extra maintenance. Thanks @craicoverflow for your suggestion and contribution! |
I think it would help projects using tools like Antora to embed CLI docs easily. Right now I have to use pandoc to convert from Markdown to Asciidoc which makes the process a bit cumbersome. Thanks @craicoverflow for great work! I hope it will be merged soon :) |
For anyone looking for a solution to having CLI documentation in Antora, I've recently done this by implementing an Antora extension. Have a look at this pull request. We use the YAML files as input and Handlebars templates to generate Asciidoc pages and place them in Antora catalog. |
This PR adds a documentation generator for Asciidoc.