Getting people to write documentation is already an uphill battle, the reality is it needs to be made as frictionless as possible or they won’t do it. IMO this rules out (La)TeX entirely: it’s just too much work that nobody wants to deal with.
I also have a philosophical issue with writing documentation in TeX: TeX is a typesetting program, i.e. it’s a presentation format meant to look a certain way on a page, while documentation should be agnostic to appearance as much as possible. But that’s more a personal objection.
I also have a philosophical issue with writing documentation in TeX: TeX is a typesetting program, i.e. it’s a presentation format meant to look a certain way on a page, while documentation should be agnostic to appearance as much as possible. But that’s more a personal objection.