11 ms·
To me, that is a separate level of decision. Sure, you could avoid the whole problem of building a docs generator by using an off-the-shelf docs generator, and
by CipherThrowaway 3y ago
To me, that is a separate level of decision. Sure, you could avoid the whole problem of building a docs generator by using an off-the-shelf docs generator, and letting the Redoc and Swagger dev teams deal with all the development complexity.
But if you are going to build your own docs generator, React and Next with RSC aren't a bad choice. Web development just isn't as simplistic as people on HN seem to think it is.
- Draiken 3y agoI agreed with most of your comment but this almost triggered me: > React and Next with RSC aren't a bad choice. Web development just isn't as simplistic as people on HN seem to think it is. Yes it fucking is. I've been doing it for 15+ years and most of the complexity added since about 10 years ago is not required. Many times they're actually regressions. The web is complex because we made it so. This is a perfect example where they could write their own docs generator with MUCH less complexity. You read a damn json/yaml file and make HTML out of it. Style it with CSS and you're finished. It's as maintainable as it gets. Now let's look at running `yarn install` in this project a year from now and see how easy it's going to be to maintain it. Odds are NextJS will be 5 versions behind and with 500 vulnerabilities found in the dependency graph.
- tacker2000 3y agoYou are of course right. But probably they got VC cash and some guy said, do it in React bla bla whatever the cost…