Minor changes to package management tutorial #10975
Conversation
A couple of minor rewords and formatting changes: - Removed the `sh` syntax highlighting on terminal sessions (anything starting with a `$`) to prevent unintentionally-highlighted words, such as the "for" in "Solution for dune.lock:". - Removed some unnecessary commas - A note about removing the version constraints from the `fmt` dependency as readers will probably forget to do this (I did!) and the resulting solver error is hard to read. - Clarified some text about pinning Signed-off-by: Stephen Sherratt <stephen@sherra.tt>
|
I finally got around to doing the package management tutorial. It's great! I've made a couple of minor tweaks here and there. |
|
Does replacing |
|
I tried replacing |
There was a problem hiding this comment.
Thanks for the improvements. Looks good but I think I would want @christinerose to comment on the full-stop-in-quotes thing.
| sources for packages; for example, if the package is not released in a package | ||
| repository. This is called "pinning." | ||
| sources of packages; for example, if the package is not released in a package | ||
| repository. This is called "pinning". |
There was a problem hiding this comment.
I think this change was deliberately done by @christinerose?
This seems to be a difference between [american and british english]. Personally I prefer the full stop to be outside the quote (as this also matches the typographic conventions of most other western languages) but I will defer the decision to native speakers :)
There was a problem hiding this comment.
Cool, I'll defer this decision to @christinerose. I feel like I'm about to learn something about english (or at least american english).
A couple of minor rewords and formatting changes:
shsyntax highlighting on terminal sessions (anything starting with a$) to prevent unintentionally-highlighted words, such as the "for" in "Solution for dune.lock:".fmtdependency as readers will probably forget to do this (I did!) and the resulting solver error is hard to read.