mirror of
https://github.com/dillonkearns/elm-pages.git
synced 2024-09-11 09:05:28 +03:00
Add an upgrade guide doc.
This commit is contained in:
parent
b3ab6464a5
commit
0007f21e0c
27
docs/upgrade-guide.md
Normal file
27
docs/upgrade-guide.md
Normal file
@ -0,0 +1,27 @@
|
||||
# `elm-pages` Upgrade Guide
|
||||
|
||||
## Upgrading to Elm Package 1.1.0 and NPM Package 1.1.2
|
||||
|
||||
Here's a diff to help guide you through the change: https://github.com/dillonkearns/elm-pages-starter/commit/5de5102d706f4a360df94e5493ceff27ebd61587.
|
||||
|
||||
### High level changes
|
||||
|
||||
- A few modules that were previously copied to the `gen` folder are now part of the published package.
|
||||
This makes it easier to discover the functionality through the package site and understand
|
||||
how to initialize an `elm-pages` app.
|
||||
- The new `StaticHttp` API now allows you to make HTTP requests during the build step that are built
|
||||
into your app's assets (see the [StaticHttp announcement blog post](http://elm-pages.com/blog/static-http)).
|
||||
If you don't have any StaticHttp data for a given page, you can use `StaticHttp.succeed` (see the
|
||||
[changes to the view function in the elm-pages-starter diff](https://github.com/dillonkearns/elm-pages-starter/commit/5de5102d706f4a360df94e5493ceff27ebd61587#diff-de84bd170bc37fbce0a7076c0125dd29L110-R142)).
|
||||
|
||||
|
||||
### Step by step upgrade checklist
|
||||
|
||||
- Be sure to install the latest NPM package *and* the latest elm package (NPM version 1.1.2 and Elm package version 1.1.0 at
|
||||
the time of this writing).
|
||||
- `elm install elm/time` (the generated `Pages.elm` has a new `builtAt` value of
|
||||
type `Time` so this needs to be installed for it to compile).
|
||||
- The `init` function now takes an additional argument, the page you're on when you load the app.
|
||||
You can just add a discarded argument [like this](https://github.com/dillonkearns/elm-pages-starter/commit/5de5102d706f4a360df94e5493ceff27ebd61587#diff-de84bd170bc37fbce0a7076c0125dd29R60).
|
||||
- The `head` function is [no longer called from `Pages.application`](https://github.com/dillonkearns/elm-pages-starter/commit/5de5102d706f4a360df94e5493ceff27ebd61587#diff-de84bd170bc37fbce0a7076c0125dd29L64) because it now has access to
|
||||
StaticHttp data. Instead, it is part of the `view` function, see [this diff](https://github.com/dillonkearns/elm-pages-starter/commit/5de5102d706f4a360df94e5493ceff27ebd61587#diff-de84bd170bc37fbce0a7076c0125dd29R141).
|
Loading…
Reference in New Issue
Block a user