Hi, Katherine Cox-Buday <cox.katherin...@gmail.com> writes:
[...] >> By the way, that's another issue. Using a TeX based document format for >> the docs is, uuuh, maybe not the best idea. Info is a pretty okayish >> documentation reader, but it's a relatively big barrier to entry >> compared to what you need to know to make a small edit to the Arch wiki. >> This way mostly just experienced contributors write docs, not the >> users who just want to document how they made some weird use case >> possible. > > Another great example. I don't write much documentation because of this. Texinfo is mostly just plain text until you learn about a few decorators :-). It gives us the info manuals that I find very nifty (it's like a man page, but with hyperlinks and advanced navigation capabilities!) and used across many GNU projects (e.g. coreutils, Emacs, Bash, GCC, GNU Make, etc.) I see it as a strength more than a weakness for the project. -- Thanks, Maxim