-
Notifications
You must be signed in to change notification settings - Fork 291
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
OCaml Tour: -New sections- Introduction and Before We Begin. Added REPL definition and double semicolon use #2336
base: main
Are you sure you want to change the base?
Conversation
… and the need for double semicolon
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, @Alfredo-Carlon I think this going in the right direction. Here are suggestions trying to push even further.
Co-authored-by: Cuihtlauac Alvarado <cuihtlauac@users.noreply.github.com>
Remove comments
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@Alfredo-Carlon What is your opinion on thoses suggestions?
|
||
To walk through the basics of OCaml by trying out different elements in an interactive manner, we'll use UTop. | ||
UTop (Universal Toplevel) allows interacting directly with OCaml by reading and evaluating OCaml phrases like expressions or value definitions and printing the result on the screen. | ||
You can run UTop by using the `utop` command. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
To walk through the basics of OCaml by trying out different elements in an interactive manner, we'll use UTop. | |
UTop (Universal Toplevel) allows interacting directly with OCaml by reading and evaluating OCaml phrases like expressions or value definitions and printing the result on the screen. | |
You can run UTop by using the `utop` command. | |
To walk through the basics of OCaml by trying out different elements in an interactive manner, we'll use UTop. You can run UTop by using the `utop` command. Exit it by pressing `Ctrl+D`. | |
UTop (Universal Toplevel) allows interacting directly with OCaml by reading and evaluating OCaml phrases like expressions or value definitions and printing the result on the screen. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@cuihtlauac
Yes we need to mention how to exit UTop :-D
I don't think the shift of sentences helps us.
This is my reasoning:
1st Sentence: Why we'll use something call UTop
2nd Sentence: What is that thing that we will use.
3rd Sentence: How you can start using it.
If we shift the sentences I feel like it breaks a bit the dynamic.
Does this make sense?
Co-authored-by: Cuihtlauac Alvarado <cuihtlauac@users.noreply.github.com>
Resolves #2324
Hi, in this I explicitly mark the Introduction and Prerequisites (Before We Begin) sections. I think it is easier to read, but I'm not sure if the Introduction got shorter :-)
In the prerequisites I also added REPL's definition and on the first example why
;;
is required.