4 ms·

This is not really comparable to Docusaurus: your thing is a little toy to publish documentation online but not really useful to create a great advanced and loo

This is not really comparable to Docusaurus: your thing is a little toy to publish documentation online but not really useful to create a great advanced and looking doc site. Just consider this: your tool requires client-side JS to work. This is very inaccessible and does not respect the progressive enhancement philosophy of the web. A Docusaurus site takes great care of accessibility, and the experience with JS disabled remains good. Also using JS this way with anchor link routing will likely lead to bad SEO, and a flash of unstyled content which gives a really bad UX.

badsectoracula 4y ago
At least as a user i find tommica's "toy" much faster and easier on the eyes than the showcase sites in Docusaurus. The only negative is that small visible "reflow" whenever a page loads. EDIT: the courier and ionic examples linked elsewhere were faster though.
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 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.

badsectoracula 4y ago

At least as a user i find tommica's "toy" much faster and easier on the eyes than the showcase sites in Docusaurus. The only negative is that small visible "reflow" whenever a page loads. EDIT: the courier and ionic examples linked elsewhere were faster though.

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 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.