Learn from Mike Shah video on OCaml

ocaml / ocaml.org

The official OCaml website.

https://ocaml.org

Other

162 stars 326 forks source link

Open cuihtlauac opened 9 months ago

cuihtlauac commented 9 months ago

This is derived from @MikeShah YouTube Video Episode 8 - First Impression - ocaml

Make it obvious place to start is utop command: applies to install instructions (http://ocaml.org/install and Installing OCaml) and A Tour of OCaml.
Add the nice 10 :: u example (at around 17:00)
Bring up explanation on single equality symbol double meaning earlier in the text
Show #help;;
Add a link to generated assembly. Some enjoy that from the beginning.
Use cat "cat" "dog" instead of cat "ha" "ha", nicer and no repetition

sabine commented 9 months ago

I don't think we can tell people to use Utop in the install instructions, but we can mention that Utop is a REPL.

Tour of OCaml, yes, maybe we can shorten the intro to make it really stand out that people should use utop.

cuihtlauac commented 9 months ago

I don't think we can tell people to use Utop in the install instructions, but we can mention that Utop is a REPL.

In https://ocaml.org/docs/installing-ocaml we already conclude by launching utop, as a sanity check. I suggest we duplicate this in https://ocaml.org/install for the same purpose.

Tour of OCaml, yes, maybe we can shorten the intro to make it really stand out that people should use utop.

We used to have something. We've deleted when we created https://ocaml.org/docs/toplevel-introduction. This is fine, but it is one click too far for some.