@@ -0,0 +1,56 @@
3+**There are no language changes**, so once you swap the `"elm-version"` in your `elm.json`, most users should be able to proceed without any further code changes. **You may run into a handful of bugfixes though!** These cases are outlined below!
8+- Parse error message quality (like [this](https://github.com/elm/error-message-catalog/issues/255) and [this](https://github.com/elm/error-message-catalog/issues/225))
9+- Faster compilation, especially for incremental compiles
10+- Uses filelocks so that cached files are not corrupted when plugins run `elm make` multiple times on the same project at the same time. (Still worth avoiding that though!)
11+- More intuitive multiline declarations in REPL
12+- Various bug fixes (e.g. `--debug`, `x /= 0`, `type Height = Height Float` in `--optimize`)
15+## Detectable Bug Fixes
17+There are three known cases where code that compiled with 0.19.0 will not compile with 0.19.1 due to bug fixes:
20+### 1. Ambiguous Imports
22+Say you have an import like this:
25+import Html exposing (min)
26+import Regex exposing (never)
32+These should be reported as ambiguous usages since the names are also exposed by `Basics`, but there was a regression in 0.19.0 described [here](https://github.com/elm/compiler/issues/1945) such that they weren't caught in specific circumstances.
34+The fix is to use a qualified name like `Html.min` or `Regex.never` to make it unambiguous.
36+We found a couple instances of this in packages and have submitted PRs to the relevant authors in August 2019. You may run into this in your own code as well.
38+For more details on why this is considered a regression, check out the details [here](https://github.com/elm/compiler/issues/1945#issuecomment-507871919) or try it in 0.18.0 to see how it worked before.
41+### 2. Tabs in Comments
43+The 0.19.0 binaries did not catch tab characters in comments. The new parser is better at checking for tabs, so it will object when it finds these.
45+Again, we found this in some packages and reached out to the relevant authors with PRs so patches would be published before the 0.19.1 release.
48+### 3. Port Module with no Ports
50+If you have any files that start with:
53+port module Main exposing (..)
56+But they do not actually have any `port` declarations, the 0.19.1 binary will ask you to switch to a normal module declaration like `module Main exposing (..)`