Open vinipsmaker opened 3 years ago
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 feature/asciidoc
.
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.