Hacker News new | past | comments | ask | show | jobs | submit login

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.



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.




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

Search: