Hacker News new | past | comments | ask | show | jobs | submit login

Indeed. We recently started a large rewrite of our product's Developer's Guide which was previously written in DocBook. All the writers are quite happy about Asciidoc and it took us only a few days of work to recreate custom additions we added to DocBook.

That being said, while the user documentation is (mostly) excellent, the developer documentation is abysmal to non-existent. On the positive side, though, the developers are quite active and responsive on Github. But if you're only writing documents instead of extending the language with new macros, you won't notice anything of that.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: