Json.Decode.lazy doc link to hint is broken

[osteele]

Steps to reproduce:

• Open https://github.com/elm-lang/core/tree/5.1.1
• Scroll to the documentation for lazy, under "Fancy Decoding"
• Click on the link to https://github.com/elm-lang/elm-compiler/blob/master/hints/recursive-alias.md "You can read more about recursive data structures here."

Expected: A documentation page

Actual: 404 error

Changing https://github.com/elm-lang/elm-compiler/blob/master/hints/recursive-alias.md to https://github.com/elm-lang/elm-compiler/blob/master/docs/hints/recursive-alias.md in src/Json/Decode.elm fixes the issue.

The reason I'm submitting this as an Issue instead of a PR fix is that src/Json/Decode.elm doesn't exist in elm-lang's branches (master and dev). As a non-contributor, I don't know enough about the workflow to know how (or whether) this can be fixed.

If it's useful, a git patch is attached.

0001-Fix-broken-link-in-Json.Decode.lazy-docs.patch.txt

[process-bot]

Thanks for the issue! Make sure it satisfies this checklist. My human colleagues will appreciate it!

Here is what to expect next, and if anyone wants to comment, keep these things in mind.

[process-bot]

Thanks for the issue! Make sure it satisfies this checklist. My human colleagues will appreciate it!

Here is what to expect next, and if anyone wants to comment, keep these things in mind.

[evancz]

Sorry for the inconvenience on that! The link should have been:

https://github.com/elm-lang/elm-compiler/blob/0.18.0/hints/recursive-alias.md

So that it could survive future code changes. I don't think there is a way to fix it retroactively, but we will be doing things in a different way in the next release such that this should not happen again!

[evancz]

Sorry for the inconvenience on that! The link should have been:

https://github.com/elm-lang/elm-compiler/blob/0.18.0/hints/recursive-alias.md

So that it could survive future code changes. I don't think there is a way to fix it retroactively, but we will be doing things in a different way in the next release such that this should not happen again!