Although it's already on your roadmap, but it definitely needs more complex examples. Fiddled around a bit with links to same-doc references. Got it to work, but took a while.
Although it's already on your roadmap, but it definitely needs more complex examples. Fiddled around a bit with links to same-doc references. Got it to work, but took a while.
I believe that natural evolution makes it easier to let the bad branches die out.
Markdown is perfectly usable.
They don't even have a Python library, which basically guarantees that AsciiDoc won't be taught in colleges.
I like AsciiDoc, but not nearly enough to mess around with installing Ruby and Gems and then having to do the same for anyone else at work that needs to build the docs for whatever reason.
Ruby is basically a non-starter for me in general. Dependency management and interpreter versioning is a pain in the ass for interpreted languages, so I'd rather have as few as possible on my system. I've already got Perl and Python installed by default, I'd rather not add a third.
https://gitlab.eclipse.org/eclipse-wg/asciidoc-wg/asciidoc.o...
It’s a long shot, but if GitHub/GitLab added render support for AsciiDoc my life would be complete.
Regardless, it’s impressive and awesome progress.