Fix iris run main.go not worked properly on some editors. Add notes for next version. Read HISTORY.md

HISTORY.md

@@ -2,6 +2,41 @@
 
 **How to upgrade**: remove your `$GOPATH/src/github.com/kataras` folder, open your command-line and execute this command: `go get -u github.com/kataras/iris/iris`.
 
+**NOTICE**:
+The next Iris version will be released **when go v1.8 stable** will be ready (it's a matter of days).
+
+
+The future version will include a ton of new features and fixes.
+
+Users should prepare their apps for:
+
+- Remove: the deprecated `.API`, it should be removed after v5(look on the v5 history tag), it's already removed from book after v5.
+
+- **MOST IMPORTANT: REMOVE**  Package-level exported `iris.Default's methods and variables`, `iris.Default` will exists but methods like `iris.Handle` should be replace with `iris.Default.Handle` or `app := iris.New(); app.Handle(...); // like before, these will never change`.
+   - Why?
+
+		Users often asked questions about built'n features and functions usage because they are being confused of the big public API (`iris.` vs `app := iris.New(); app.`).
+		This removal will also let me to describe the types with more sense.
+
+- NEW feature: `app.Adapt(iris.Policy)` which you will be able to adapt a **custom http router**, **custom template functions**, **custom http router wrappers**, **flow events** and much more. I'll cover these on book and examples when it will be released.
+
+- Replace: `.Plugins.` with `EventPolicy`: `app.Adapt(iris.EventPolicy{ Boot: func(*iris.Framework){}} )`.
+
+- Replace: `.AcquireCtx/.ReleaseCtx` with `app.Context.Acquire/Release/Run`.
+
+- NEW feature: able to pass an `func(http.ResponseWriter, *http.Request, http.HandlerFunc)` third-party net/http middleware like normal
+iris.HandlerFunc with `iris.ToHandler`. (I already pushed that to the current version,  because I think it will make your life easier now).
+
+- FIX: `iris run main.go` didn't reload the app on file changes when saving a source file via some IDEs,
+because they do override the operating system's fs signals. The majority of
+editors worked before but I couldn't let some developers without support. (I already pushed that to the current version)
+
+- FIX: custom routers not working well with static file serving, reverse routing and per-party http custom errors.
+
+- NEW: HTTP/2 Push `context.Push`
+
+The full list of next version's features among with one by one steps to refactor your code in breaking-cases will be noticed here when it will be released.
+
 ## 6.1.2 -> 6.1.3
 
 - Added a configuration field `iris.Config.DisableBodyConsumptionOnUnmarshal`