A list of stuff that can be improved on the freshly release Elm 0.19 Guide https://guide.elm-lang.org

Elm019GuideTodos.md

This is taken from a thread on slack that tried unsuccessfully to coordinate issues of the guide :-)

• install.html: https://github.com/elm/compiler/blob/master/docs/repl.md is a 404 linked from https://guide.elm-lang.org/install.html at "about how it works here"
• install.html: "Do you need [elm-lang/time][time]?" also in install page. looks like a markdown link that didn't work. (going through the guide)
• install.html: The link to noredink json-decode-pipeline in install page points to https://package.elm-lang.org/packages/NoRedInk/json-decode-pipeline/latest instead of https://package.elm-lang.org/packages/NoRedInk/elm-json-decode-pipeline/latest/ (the "elm-" was kept in the end)
• install.html: The example just after the link also mix the two:

elm install NoRedInk/elm-decode-pipeline

instead of:

elm install NoRedInk/elm-json-decode-pipeline

• It's probably a good idea to mention in the guide that tuples are restricted to 3-tuples at most https://guide.elm-lang.org/core_language.html
• https://elm-lang.org/try is a 404 - maybe switch that to Ellie?
• The install link at the very bottom links .md instead of the .html it should link https://guide.elm-lang.org/architecture/
• install.html: In install page of guide, it shows an elm repl output like:

 :help for help, :exit to exit, more at <https://github.com/elm-lang/elm-repl>
--------------------------------------------------------------------------------```

In the following page core_language it shows:

```---- Elm 0.19.0 ----------------------------------------------------------------
Read <https://elm-lang.org/0.19.0/repl> to learn more: exit, help, imports, etc.
--------------------------------------------------------------------------------```

The second one is the correct one (should change the one in install page)

• install.html: The link in the correct one though is to a page not finished yet (https://elm-lang.org/0.19.0/repl)
• core_language.html: when talking about syntax like space for function application, there is the sentence: "The elm/html package is a good example of how this keeps things feeling light" and elm/html is pointing to https://elm-lang.org/blog/blazing-fast-html-round-two. This is maybe intentional but a bit weird to put this link here.
• The first link in the Introduction page, a simple counter. links to http://try.elm-lang.org/examples/buttons which isn't the 0.19 version of the code yet
• In https://guide.elm-lang.org/effects/ the "Elm asset sizes are exceptionally small" links to https://elm-lang.org/blog/TODO
• The markdown link here https://guide.elm-lang.org/effects/time.html under subscriptions to We are using the [Time.every][every] function here is mangled
• On https://guide.elm-lang.org/effects/json.html the json functions still link to elm/core instead of elm/json
• architecture.html: at end of page, in "if you have Elm installed" points to https://guide.elm-lang.org/install.md instead of https://guide.elm-lang.org/install.html
• function_types.html: there is a stray ß character at the end of a line
• reading_types.html: The still figures out the type on its own is missing the word compiler
• Last link on this page is broken: https://guide.elm-lang.org/optimization/asset_size.html It links to https://guide.elm-lang.org/optimization/TODO but when you click it doesn't go to a new page

Suggestions (just for myself ^.^):

• I think it'd be time to switch from document.getElementById(..) to document.querySelector(...) on https://guide.elm-lang.org/interop/flags.html
• it'd be nice to mention on this page in the notes that server side rendering in the sense of "create markup from data on the server, send html to the client and rehydrate the state clientside without rerendering the whole markup" like most JS webstuff has is currently not fully supported, maybe mention Noah's elm-static-html-lib when that is migrated to Elm 0.19? https://guide.elm-lang.org/webapps/