[Docs] Update changelog, upgrade guide and bump version

lindyhopchris · lindyhopchris · commit 6e43c38bc08e · 2018-07-02T07:17:59.000+01:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,7 +2,7 @@
 All notable changes to this project will be documented in this file. This project adheres to
 [Semantic Versioning](http://semver.org/) and [this changelog format](http://keepachangelog.com/).
 
-## Unreleased
+## [1.0.0-alpha.4] - 2018-07-02
 
 ### Added
 - [#203](https://github.com/cloudcreativity/laravel-json-api/issues/203)
diff --git a/README.md b/README.md
@@ -27,9 +27,9 @@ A demo application is available at [here](https://github.com/cloudcreativity/dem
 
 | Laravel | This Package |
 | --- | --- |
-| 5.4.* | `1.0.0-alpha.3` |
-| 5.5.* | `1.0.0-alpha.3` |
-| 5.6.* | `1.0.0-alpha.3` |
+| 5.4.* | `1.0.0-alpha.4` |
+| 5.5.* | `1.0.0-alpha.4` |
+| 5.6.* | `1.0.0-alpha.4` |
 
 Make sure you consult the [Upgrade Guide](http://laravel-json-api.readthedocs.io/en/latest/upgrade/) when upgrading.
 
diff --git a/docs/upgrade.md b/docs/upgrade.md
@@ -6,6 +6,15 @@ We are now on `1.0.0` alpha releases. We are planning incremental changes during
 will involve only small upgrades. We will do one final large upgrade when we switch from alpha to beta releases,
 and then we are planning on tagging `1.0.0` after a limited number of beta tags.
 
+## 1.0.0-alpha.3 to 1.0.0-alpha.4
+
+If your application is served/installed in a sub-directory, you may need to amend your API's URL configuration as
+we now automatically appended the base URL to the URLs that appear within encoded responses.
+[See this issue for details.]()
+
+This change is unlikely to affect most installs, so you are likely to be able to upgrade to `1.0.0-alpha.4` without
+any changes.
+
 ## 1.0.0-alpha.2 to 1.0.0-alpha.3
 
 ### Exception Handler
