I would absolutely kill for them to open source their documentation system.
back
1 comments
Are you referring to our RFD system?[0][1] Because if so, good news![2]
[0] https://rfd.shared.oxide.computer/rfd/0001
[1] https://oxide-and-friends.transistor.fm/episodes/rfds-the-ba...
OMG, you just made my day!
does this mean that you won't be killing anyone?
They might still be available for killing someone out of gratitude
Sacrifices for future bountiful harvests
Why would a “doc system” use React?
Because it’s a web site.
Because HTML/CSS apparently isn't enough for documentation. /s
React is one way of generating HTML.
A heavy way that, as typically used, goes against the grain of the web, particularly for document-centric sites. For example, on the Oxide RFD site, the RFD links don't do a real browser page load, but use JavaScript to fetch the new content and update the page in-place. This breaks the experience of screen-reader users unless the site or framework does some kind of workaround (which, somewhat to my surprise, the Oxide RFD site doesn't do), and even then, it doesn't match the experience of doing a real transition between pages with a screen reader. For something like the Oxide RFD site, I'd be much more inclined to use something like Astro or Marko, with minimal client-side JavaScript and no SPA-style navigation.
Why shouldn't a doc system use React? One word answers consisting of the word bloat are not going to be accepted, please use your words and be specific. The router sucks, the language is ass, give details!
It’s best for SPAs. A pile of docs and comments does not require nor gain much from it. i.e. a poor tradeoff, at first glance anyway.