31 ms·
As the rep for a product: I wouldn't recommend bashing someone's project by calling it a "little toy". It works for them regardless if it looks as "fancy" as yo
by michaelmcdonald 4y ago
As the rep for a product: I wouldn't recommend bashing someone's project by calling it a "little toy". It works for them regardless if it looks as "fancy" as yours. Not a positive look for you or your project if this is how you're going to treat others.
- slorber 4y agoMaybe 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.