Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Maybe the word "toy" is wrong and I'm sorry for that if it offended anymore

But I stand by that such documentation tools are really not great. I've argued why here: https://news.ycombinator.com/item?id=32305770

Now if you clearly understand the tradeoffs of such tools and still decide to use it, that's fine. What I see in practice is that many decide to use such tool and are not really aware of the tradeoffs they make.

I personally believe being accessible is a mandatory feature for any documentation website framework. But maybe you'll publish the docs just for yourself or a very limited set of persons, in which case you might care less.



Consider applying for YC's Winter 2026 batch! Applications are open till Nov 10

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

Search: