reasonml.org

reasonml.org copied to clipboard

Add pages title

2

I just noticed that pages don't have a title. I am willing to implement this feature.

montogeek

Since @sgrove sparked the idea, this thread is dedicated for all kinds of feedback / complaints about Reason documentation scattered around the internet [Something's wrong with the Belt Docs](https://twitter.com/jensc/status/1254790259725959168)

ryyppy

Ideas for homepage example code

2

Both [reasonml.github.io](https://reasonml.github.io/) and [bucklescript.github.io](https://bucklescript.github.io/) have code examples at the top of their homepage, which got me thinking about the reasonml.org wanted to use something similar. I think the [Node.js about...

johnridesabike

Add [@bs.open] to the decorator overview as well. Here is the original doc: https://bucklescript.github.io/bucklescript/Manual.html#__code_bs_open_code_type_safe_external_data_source_handling_since_1_7_0

ryyppy

As noted by @sgrove, some decorators are missing in the index. One of them being `[@bs.nullable]`. Example: https://github.com/BuckleScript/bucklescript/blob/6c6e948cc04e1615041f400080d15d3a40be7e3e/jscomp/test/return_check.ml#L63

ryyppy

Add Docs for Union Types via the [@unboxed] feature

1

Create a standalone page "Union Types", which basically translates the previous BS blog posts into a more formal documentation page: - [Union Types in BS](https://bucklescript.github.io/blog/2020/02/07/union-types-in-bucklescript) - [BS 7.2 Holiday release](https://bucklescript.github.io/blog/2019/12/20/release-7-02)...

ryyppy

Add links to source code for functions

4

I think it would be useful to have links to the source code with the function definitions. For BuckleScript, it may be also be good to link to the compiled...

johnridesabike

Convert the ocaml-manual to Reason flavoured Markdown

3

The [ocaml-manual](https://caml.inria.fr/pub/docs/manual-ocaml/) is the official handbook for using OCaml. It fully describes all features and syntax elements and is highly valuable for explaining complex mechanisms, such as GADTs or polymorphic...

ryyppy

Add Docs for First Class Modules

3

First Class Modules were not documented in Reason so far, mostly on purpose to not overwhelm early adopters of the language, and due to fear that ppl will go crazy...

ryyppy

Markdown Tab Component

4

The official ReasonML docs started using Docusaurus' tabable component to make the code examples more compact:  We need an equivalent to represent the same code snippet in different languages...

ryyppy