-
Notifications
You must be signed in to change notification settings - Fork 4
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
Use asciidoc to document new pages #58
Comments
Yes. In fact, I started converting the documentation to asciidoc four years ago, but never completed it due to time constraints. |
I see it's still open, you can send the unfinished asciidoc files and i can finish then and start moving things to a antora documentation, i think it would be better to use it, since it's the recommended by asciidoctor and includes a pretty good UI already by default. |
@breese, @lemosjose has been helping me with docs infra in a project of mine. You can see a live example of the Antora he mentioned at https://emilua.gitlab.io/docs/. |
I have pushed my initial conversion to the branch I do not recall exactly how much was done, but I suspect very little. |
So Boost.Predef already uses asciidoc to document stuff: https://github.com/boostorg/predef/blob/caa0627ab5518333d8c0f272667140c793adca1d/doc/build.jam#L8
Could we use asciidoc from now on too? Current docs kind of stalled already, so I guess it's not very “fun” to touch QuickBook. Maybe asciidoc helps.
The text was updated successfully, but these errors were encountered: