OCamlverse/ocamlverse.github.io

There are two places where the quickstart says it is creating the switch

Opened this issue · 1 comments

After the line, "Do not update project_name.opam manually! Let dune do it for you" there is a heading, "OPAM SWITCH" where it shows the reader how to create a local switch. This section is well-written and does indeed show the reader how to create the local switch.

But then, after that, the following sections appear: "LOCKING DEPENDENCIES", "USING GIT", and "EXPANDING OUR DUMMY APPLICATION". And they are followed by another section called "OPAM SWITCH" which begins, "Next up, we are going to create an opam switch."

This is confusing because we already created the switch several sections earlier. And it's even more confusing because after a brief introductory paragraph, nothing more is said in that section about switches. Instead, it talks about how to use libraries.

I suspect that at some point in the evolution of the quickstart, things were reordered and mixed up and that the second "OPAM SWITCH" heading, and the paragraph that follows it, should have been deleted.

I created PR 179 to address this.