Streamline opam package installs and REPL usage#251
Conversation
Install all opam dev tool packages in one shot, instead of piecemeal. This is more efficient with the user's time. Use utop directly instead of spending paragraphs showing the `ocaml` toplevel, then talking about `rlwrap`. For beginners, `ocaml` toplevel and `rlwrap` are almost certainly irrelevant when utop exists.
|
@christinerose thanks for the review. I believe the standard way to refer to the tools is 'opam' and 'utop' (lowercase). This casing is used in the tutorial currently: https://github.com/ocaml/v3.ocaml.org-server/blob/5631257eb3ab0602cfed4b1088d6208e401a5767/data/tutorials/en/000_up_and_running.md |
|
Thank you for pointing that out @yawaramin. We're in the process of reviewing and updating all documentation, so we'll have a discussion about consistent formatting. |
|
Thank you. Consistence and standardized formats is a great discussion to have but is that a blocker for this PR? The formatting used here follows the norms of the document as it is currently written. If those change, that can be done in a separate update, no? |
|
It's not blocking this PR at all. I'll open another one in the future. |
Somehow the instructions in this document got mixed up with recent changes from ocaml#251 . Fix up the install and toplevel usage instructions.
Somehow the instructions in this document got mixed up with recent changes from #251 . Fix up the install and toplevel usage instructions.
2 participants
Install all opam dev tool packages in one shot, instead of piecemeal. This is
more efficient with the user's time.
Use utop directly instead of spending paragraphs showing the
ocamltoplevel,then talking about
rlwrap. For beginners,ocamltoplevel andrlwraparealmost certainly irrelevant when utop exists.