Remove outdated content #719
Conversation
The Reason Association is using ReScript, and Hemnet needs to be taken down for legal / copyright reasons (wanted to aid @believer in getting this change upstream)
- Update marketing blocks - Remove ReScript related quick start - Remove unrelated examples section (these are all outdated ReScript projects)
Remove outdated and wrong installation instructions and add an esy / hello-reason quickstart example.
These two pages were almost exclusively targeted to old BuckleScript conventions, that aren't even up to date. Removing this info will help not mixing up BuckleScript'isms with native development.
Like the landing page, the examples are terribly outdated and don't reflect modern Reason at all.
This page is terribly outdated as well
There was a problem hiding this comment.
Thanks for working on this, definitely a big improvement from the mixed state we were in!
I left a few comments for things easy to fix, and I think there are some things we can refine later, but I don't mind getting this in first and coming back to refine since the docs are in such a confusing place already :)
The one area that I do want to fix up first is in the FAQ, and the explanations around Reason vs ReScript. @jordwalke can take a look there, for now it might be easiest to simply link to the other articles rather than re-hashing the explanations in the FAQ. If you think it's important to have that in the FAQ with that much detail we can give more concrete feedback though
- Added note on ReScript JSX docs for ReasonReact usage - Removed ReasonReact / BuckleScript mentions - Added ReveryUI as a framework using the JSX semantics
Some companies seem to be gone, and I couldn't find any sign of being renamed / being acquired, so I removed them.
|
Just realized that the JSX, Object, and External docs still had some BuckleScript related content. Refactored that by putting in Reason / OCaml native equivalents. |
|
Okay, I think now it's ready for a last quick read.. FAQ part was reduced to a minimum + link to the ReScript blog post. |
|
Thanks, I'll give this a final pass tomorrow and see if I spot anything else before merging. |
|
Thank you @ryyppy for working on this! |
|
Thanks Kyle! |
Motivation
The Reason community and ReScript forum gets flooded with questions regarding Reason / ReScript, and many of those are caused by outdated content in the ReasonML documentation website.
This PR is an attempt to clear the docs from any outdated references of BuckleScript / ReScript (at least where it makes sense). I also took the chance and removed a lot of stale content that doesn't make any sense in the current mission of ReasonML (the one where Reason tries to be 100% OCaml compliant, with a primary native compilation story, powered by esy, dune, OCaml and JSOO).
Change Summary
I'd appreciate a review rather soon. The website has been in this mixed state for more than 6 months now, and it's kinda misleading for newcomers.
\cc @cristianoc