diff --git a/Content-negotiation.md b/Content-negotiation.md
new file mode 100644
index 0000000..88f74f0
--- /dev/null
+++ b/Content-negotiation.md
@@ -0,0 +1,108 @@
+**Sometimes a server application needs to serve different representations of a resource at the same URI**. Of course this can be done by hand, manually checking the `Accept` request header and push the requested form of the content. However, as your app manages more resources and different kind of representations this can be very painful, as you may need to check for `Accept-Charset`, `Accept-Encoding`, put some server-side priorities, handle the errors correctly and e.t.c.
+
+There are some web frameworks in Go already struggle to implement a feature like this but they don't do it correctly:
+
+- they don't handle accept-charset at all
+- they don't handle accept-encoding at all
+- they don't send error status code (406 not acceptable) as RFC proposes and more...
+
+But, fortunately for us, **Iris always follows the best practises and the Web standards**.
+
+Based on:
+- https://developer.mozilla.org/en-US/docs/Web/HTTP/Content_negotiation
+- https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept
+- https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Charset
+- https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding
+
+Implemented on:
+- https://github.com/kataras/iris/pull/1316/commits/8ee0de51c593fe0483fbea38117c3c88e065f2ef
+
+---------
+
+## Example
+
+```go
+type testdata struct {
+ Name string `json:"name" xml:"Name"`
+ Age int `json:"age" xml:"Age"`
+}
+```
+
+Render a resource with "gzip" encoding algorithm
+as application/json or text/xml or application/xml
+
+- when client's accept header contains one of them
+- or JSON (the first declared) if accept is empty,
+- and when client's accept-encoding header contains "gzip" or it's empty.
+
+```go
+app.Get("/resource", func(ctx iris.Context) {
+ data := testdata{
+ Name: "test name",
+ Age: 26,
+ }
+
+ ctx.Negotiation().JSON().XML().EncodingGzip()
+
+ _, err := ctx.Negotiate(data)
+ if err != nil {
+ ctx.Writef("%v", err)
+ }
+})
+
+```
+
+**OR** define them in a middleware and call Negotiate with nil in the final handler.
+
+```go
+ctx.Negotiation().JSON(data).XML(data).Any("content for */*")
+ctx.Negotiate(nil)
+```
+
+```go
+app.Get("/resource2", func(ctx iris.Context) {
+ jsonAndXML := testdata{
+ Name: "test name",
+ Age: 26,
+ }
+
+ ctx.Negotiation().
+ JSON(jsonAndXML).
+ XML(jsonAndXML).
+ HTML("Test Name
Age 26
")
+
+ ctx.Negotiate(nil)
+})
+```
+
+[Read the full example](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/_examples/http_responsewriter/content-negotiation/main.go#L22).
+
+
+## Documentation
+
+The [Context.Negotiation](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/context/context.go#L3342) method creates once and returns the negotiation builder
+to build server-side available prioritized content for specific content type(s), charset(s) and encoding algorithm(s).
+
+```go
+Context.Negotiation() *context.NegotiationBuilder
+```
+
+The [Context.Negotiate](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/context/context.go#L3402) method used for serving different representations of a resource at the same URI. It returns `context.ErrContentNotSupported` when not matched mime type(s).
+
+- The "v" can be a single [iris.N](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/context/context.go#L3298-L3309) struct value.
+- The "v" can be any value completes the [context.ContentSelector](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/context/context.go#L3272) interface.
+- The "v" can be any value completes the [context.ContentNegotiator](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/context/context.go#L3281) interface.
+- The "v" can be any value of struct(JSON, JSONP, XML, YAML) or
+string(TEXT, HTML) or []byte(Markdown, Binary) or []byte with any matched mime type.
+- If the "v" is nil, the `Context.Negotitation()` builder's
+content will be used instead, otherwise "v" overrides builder's content
+(server mime types are still retrieved by its registered, supported, mime list)
+
+- Set mime type priorities by [Negotiation().MIME.Text.JSON.XML.HTML...](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/context/context.go#L3500-L3621).
+- Set charset priorities by [Negotiation().Charset(...)](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/context/context.go#L3640).
+- Set encoding algorithm priorities by [Negotiation().Encoding(...)](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/context/context.go#L3652-L3665).
+- Modify the accepted by [Negotiation().Accept./Override()/.XML().JSON().Charset(...).Encoding(...)...](https://github.com/kataras/iris/blob/8ee0de51c593fe0483fbea38117c3c88e065f2ef/context/context.go#L3774-L3877).
+
+```go
+Context.Negotiate(v interface{}) (int, error)
+```
\ No newline at end of file
diff --git a/Home.md b/Home.md
index 544a3af..d9bd727 100644
--- a/Home.md
+++ b/Home.md
@@ -22,6 +22,7 @@ This wiki is the main source of documentation for **developers** working with (o
* [[Override Context|Routing-override-context]]
* [[Context Methods|Routing-context-methods]]
* [[API Versioning]]
+* [[Content Negotiation]]
* [[HTTP Referer]]
* [[Request Authentication]]
* [[URL Query Parameters]]
diff --git a/Installation.md b/Installation.md
index 0a19a8a..4ed92e6 100644
--- a/Installation.md
+++ b/Installation.md
@@ -3,7 +3,7 @@ Iris is a cross-platform software.
The only requirement is the [Go Programming Language](https://golang.org/dl/), version 1.12 and above.
```sh
-$ go get github.com/kataras/iris@v11.2.2
+$ go get github.com/kataras/iris@v11.2.3
```
Or inside your `go.mod` file:
@@ -14,7 +14,7 @@ module your_project_name
go 1.12
require (
- github.com/kataras/iris v11.2.2
+ github.com/kataras/iris v11.2.3
)
```
diff --git a/_Sidebar.md b/_Sidebar.md
index 3c15059..2c193ee 100644
--- a/_Sidebar.md
+++ b/_Sidebar.md
@@ -17,6 +17,7 @@
* [[Override Context|Routing-override-context]]
* [[Context Methods|Routing-context-methods]]
* [[API Versioning]]
+* [[Content Negotiation]]
* [[HTTP Referer]]
* [[Request Authentication]]
* [[URL Query Parameters]]