4 ms·
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
by slorber 4y ago
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 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.