rescript-lang.org icon indicating copy to clipboard operation
rescript-lang.org copied to clipboard

Add link from legacy Js modules to their current Core equivalents.

Open gaspard opened this issue 1 year ago • 4 comments

Having a clear warning that Core supersedes Js helps remove some confusion for newcomers. It also avoids people trying to understand code samples that use legacy features such as |>.

gaspard avatar Jun 08 '24 12:06 gaspard

@gaspard is attempting to deploy a commit to the ReScript Association Team on Vercel.

A member of the Team first needs to authorize it.

vercel[bot] avatar Jun 08 '24 12:06 vercel[bot]

@gaspard, thanks for the contribution!!

json files are generated by the document generator @recript/tools. I like the idea of ​​adding a deprecation message.

It's better to do this in next.js side, here

aspeddro avatar Jun 09 '24 21:06 aspeddro

@aspeddro would we not need to add the deprecation messages to the compiler sources themselves?

fhammerschmidt avatar Jun 13 '24 09:06 fhammerschmidt

If when Core was added in the compiler and keeping Js for some time it makes sense to add @deprecated in the Js module. But since Core is now an independent package it doesn't make sense to add any @deprecated in Js.

In short, it depends on how the transition from Js to Core will be in the compiler

aspeddro avatar Jun 13 '24 14:06 aspeddro

The Js module docs are now legacy and can no longer be found on the site.

jderochervlk avatar Nov 26 '25 00:11 jderochervlk