From 3d2463cb4710bd7810f2e28ae85097e4fde8c96c Mon Sep 17 00:00:00 2001
From: Juraj Misur <juraj.misur@gmail.com>
Date: Fri, 1 Sep 2017 00:11:26 +0200
Subject: [PATCH 1/3] improved documentation and readme

---
 README.md                                     |  35 +++---
 docs/index.html                               | 115 +++++++++++++++---
 spring-auto-restdocs-docs/constraints.adoc    |  24 ++++
 .../getting-started.adoc                      |   7 +-
 spring-auto-restdocs-docs/index.adoc          |  12 +-
 spring-auto-restdocs-docs/other.adoc          |  26 ++++
 .../section-snippet.adoc                      |   2 -
 spring-auto-restdocs-docs/snippets.adoc       |  17 ++-
 .../generated-docs/index.html                 |  10 +-
 9 files changed, 196 insertions(+), 52 deletions(-)
 create mode 100644 spring-auto-restdocs-docs/other.adoc

diff --git a/README.md b/README.md
index 6ee146f6..0e6dd919 100644
--- a/README.md
+++ b/README.md
@@ -22,27 +22,30 @@ from the Introducing Spring Auto REST Docs talk at Spring IO 2017 are also avail
 
 ## Documentation
 
-* [Latest / master](https://scacap.github.io/spring-auto-restdocs)
+[Current 1.0.8 release](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/v1.0.8/docs/index.html) reference guide.
 
-* [Version 1.0.8](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/f0a49f1f3c429a7fd17c25e98806fc5bad08429c/docs/index.html)
+Latest master [1.0.9-SNAPSHOT](https://scacap.github.io/spring-auto-restdocs) reference guide.
 
-* [Version 1.0.7](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/25464f899d96cba889e48de309f0ee878588afe2/docs/index.html)
-
-* [Version 1.0.6](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/b2a1bbb12f7a7ccf499bc81d6caebe8f7a449321/docs/index.html)
-
-* [Version 1.0.5](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/12ad534d101363edfd1d41b22507c602e004b489/docs/index.html)
-
-* [Version 1.0.4](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/3d78a2deb0f0a880c40426417f0cd0bfb02d34a6/docs/index.html)
+Older releases: 
+[1.0.7](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/v1.0.7/docs/index.html), 
+[1.0.6](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/v1.0.6/docs/index.html), 
+[1.0.5](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/v1.0.5/docs/index.html), 
+[1.0.4](https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/v1.0.4/docs/index.html).
 
 ## Main features
 
-* Automatic documentation of request and response fields.
-* Automatic documentation of path and query parameters.
-* Automatic documentation of field and parameter constraints
-* A helper to document authentication.
-* A snippet that includes all other snippets.
-* Shorten JSON arrays in example requests and responses.
-* Replace binary example requests and responses with `<binary>`.
+* Automatic documentation of 
+[request](https://scacap.github.io/spring-auto-restdocs/#snippets-request-fields) and 
+[response](https://scacap.github.io/spring-auto-restdocs/#snippets-response-fields) fields, 
+[path](https://scacap.github.io/spring-auto-restdocs/#snippets-path-parameters) and 
+[query](https://scacap.github.io/spring-auto-restdocs/#snippets-request-parameters) parameters using Jackson and Javadoc
+* Automatic documentation of field and parameter 
+[optionality](https://scacap.github.io/spring-auto-restdocs/#constraints-optionality) and 
+[constraints](https://scacap.github.io/spring-auto-restdocs/#constraints) using JSR 303 annotations
+* Automatic documentation of [entire endpoint](https://scacap.github.io/spring-auto-restdocs/#snippets-section) with [customizations](https://scacap.github.io/spring-auto-restdocs/#snippets-section-customization)
+* A helper to document [authentication](https://scacap.github.io/spring-auto-restdocs/#snippets-authorization)
+* Support for [paging](https://scacap.github.io/spring-auto-restdocs/#paging)
+* Convenient [preprocessors](https://scacap.github.io/spring-auto-restdocs/#preprocessors)
 
 ## Usage
 
diff --git a/docs/index.html b/docs/index.html
index ec971967..5b07c3da 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -460,6 +460,12 @@ <h1>Spring Auto REST Docs</h1>
 <li><a href="#constraints-groups">Constraint groups</a></li>
 </ul>
 </li>
+<li><a href="#other">Other</a>
+<ul class="sectlevel2">
+<li><a href="#paging">Paging support</a></li>
+<li><a href="#preprocessors">Preprocessors</a></li>
+</ul>
+</li>
 <li><a href="#contributing">Contributing</a>
 <ul class="sectlevel2">
 <li><a href="#contributing-building">Building from source</a></li>
@@ -530,11 +536,11 @@ <h2 id="faq"><a class="link" href="#faq">FAQ</a></h2>
 <li>
 <p><em>Is a multi-module project setup supported?</em></p>
 <p>The JSON doclet and the REST Docs snippets produce files.
-Therefore, all results can be copied across modules or projects.
-Instead of copying, multiple source directories for
-the JSON files can be configured with the <code>javadocJsonDir</code> property.
-Directories are separated by <code>,</code> and are processed in order
-and only the first found JSON file is used.</p>
+Therefore, all files should be placed on the filesystem.
+JSON files files will be additionally looked up from classpath,
+so modularization of codebase is fully supported.
+For advanced customization, multiple source directories for the JSON files
+can be configured (see <a href="#gettingstarted-usage">usage</a>).</p>
 </li>
 </ol>
 </div>
@@ -707,6 +713,7 @@ <h3 id="gettingstarted-usage"><a class="link" href="#gettingstarted-usage">Usage
 <li>
 <p>Configure MockMvc</p>
 <div class="listingblock">
+<div class="title">Test class</div>
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-java" data-lang="java">@Autowired
 private WebApplicationContext context;
@@ -758,10 +765,12 @@ <h3 id="gettingstarted-usage"><a class="link" href="#gettingstarted-usage">Usage
 <div class="sect2">
 <h3 id="gettingstarted-sample"><a class="link" href="#gettingstarted-sample">Sample application</a></h3>
 <div class="paragraph">
-<p><a href="https://github.com/ScaCap/spring-auto-restdocs/tree/master/spring-auto-restdocs-example">This project</a> includes a sample application that demonstrates most features:</p>
+<p><a href="https://github.com/ScaCap/spring-auto-restdocs/tree/master/spring-auto-restdocs-example">This project</a>
+includes a sample application that demonstrates most features.</p>
 </div>
 <div class="paragraph">
-<p>The generated documentation of the example project can be viewed <a href="https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/master/spring-auto-restdocs-example/generated-docs/index.html">here</a>.</p>
+<p>The generated documentation of the example project can be viewed
+<a href="https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/master/spring-auto-restdocs-example/generated-docs/index.html">here</a>.</p>
 </div>
 </div>
 </div>
@@ -792,7 +801,8 @@ <h3 id="snippets-method-path"><a class="link" href="#snippets-method-path">Metho
 <div class="sect2">
 <h3 id="snippets-description"><a class="link" href="#snippets-description">Description snippet</a></h3>
 <div class="paragraph">
-<p><a href="https://github.com/ScaCap/spring-auto-restdocs/blob/master/spring-auto-restdocs-core/src/main/java/capital/scalable/restdocs/misc/DescriptionSnippet.java">Description snippet</a> outputs the Controller&#8217;s method&#8217;s Javadoc. Currently only basic <code>&lt;br&gt;</code> and <code>&lt;p&gt;</code> tags are supported.</p>
+<p><a href="https://github.com/ScaCap/spring-auto-restdocs/blob/master/spring-auto-restdocs-core/src/main/java/capital/scalable/restdocs/misc/DescriptionSnippet.java">Description snippet</a> outputs the Controller&#8217;s method&#8217;s Javadoc.
+Currently only basic <code>br</code>, <code>p</code>, <code>ul</code> and <code>li</code> tags are supported.</p>
 </div>
 <div class="listingblock">
 <div class="title">Code</div>
@@ -800,9 +810,11 @@ <h3 id="snippets-description"><a class="link" href="#snippets-description">Descr
 <pre class="highlightjs highlight"><code class="language-java" data-lang="java">/**
  * Returns list of all items.
  * &lt;p&gt;
- * Use query parameters to filter the list by:&lt;br&gt;
- * - orderNumber&lt;br&gt;
- * - type
+ * Use query parameters to filter the list by:
+ * &lt;ul&gt;
+ *   &lt;li&gt;orderNumber&lt;/li&gt;
+ *   &lt;li&gt;type&lt;/li&gt;
+ * &lt;/ul&gt;
  */
 @RequestMapping...
 public ItemResponse getItems() { ... }</code></pre>
@@ -989,8 +1001,8 @@ <h3 id="snippets-request-fields"><a class="link" href="#snippets-request-fields"
 <td class="tableblock halign-left valign-top"><p class="tableblock">description</p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Item description.<br>
-Size must be between 0 and 20 inclusive.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Item description.
+</p><p class="tableblock">Size must be between 0 and 20 inclusive.</p></td>
 </tr>
 </tbody>
 </table>
@@ -1049,8 +1061,8 @@ <h3 id="snippets-response-fields"><a class="link" href="#snippets-response-field
 <td class="tableblock halign-left valign-top"><p class="tableblock">orderNumber</p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">Integer</p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Item&#8217;s order number.<br>
-Must be at least 1.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Item&#8217;s order number.
+</p><p class="tableblock">Must be at least 1.</p></td>
 </tr>
 </tbody>
 </table>
@@ -1311,6 +1323,43 @@ <h2 id="constraints"><a class="link" href="#constraints">Documenting constraints
 and the constraint groups to derive whether a field is optional
 and to add the constraint descriptions to the field descriptions.</p>
 </div>
+<div class="listingblock">
+<div class="title">Example</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java" data-lang="java">/**
+ * Username
+ */
+@NotNull
+@Size(min = 2, max = 50)
+private String username;</code></pre>
+</div>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Result</caption>
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 25%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Parameter</th>
+<th class="tableblock halign-left valign-top">Type</th>
+<th class="tableblock halign-left valign-top">Optional</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">username</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Username.
+</p><p class="tableblock">Size must be between 2 and 50.</p></td>
+</tr>
+</tbody>
+</table>
 <div class="sect2">
 <h3 id="constraints-optionality"><a class="link" href="#constraints-optionality">Constraint that determine optionality</a></h3>
 <div class="paragraph">
@@ -1476,6 +1525,40 @@ <h5 id="constraints-examples-fields"><a class="link" href="#constraints-examples
 </div>
 </div>
 <div class="sect1">
+<h2 id="other"><a class="link" href="#other">Other</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="paging"><a class="link" href="#paging">Paging support</a></h3>
+<div class="paragraph">
+<p>Paging support in an endpoint is automatically recognized if request handler method contains <code>Pageable</code> parameter
+and response is of type <code>Page</code>. This is then mentioned in request and response snippets by linking
+to common section explaining the details of supported paging parameters/fields.
+This section have to be created manally and must be tagged as <code>[[overview-pagination]]</code>.
+See example project for <a href="https://github.com/ScaCap/spring-auto-restdocs/blob/master/spring-auto-restdocs-example/src/main/asciidoc/index.adoc#overview-pagination">paging section</a> template.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="preprocessors"><a class="link" href="#preprocessors">Preprocessors</a></h3>
+<div class="paragraph">
+<p>Preprocessors are available for use in order to improve the quality of endpoint examples.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="https://github.com/ScaCap/spring-auto-restdocs/blob/master//spring-auto-restdocs-core/src/main/java/capital/scalable/restdocs/response/BinaryReplacementContentModifier.java">binary replacement</a>: replaces content with <code>&lt;binary&gt;</code> for common mime types</p>
+</li>
+<li>
+<p><a href="https://github.com/ScaCap/spring-auto-restdocs/blob/master//spring-auto-restdocs-core/src/main/java/capital/scalable/restdocs/response/ArrayLimitingJsonContentModifier.java">limit json array length</a>: limits all arrays in json to 3 items</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For list of standard preprocessors see <a href="https://github.com/spring-projects/spring-restdocs/blob/master/spring-restdocs-core/src/main/java/org/springframework/restdocs//operation/preprocess/Preprocessors.java">Preprocessors</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="contributing"><a class="link" href="#contributing">Contributing</a></h2>
 <div class="sectionbody">
 <div class="sect2">
@@ -1554,7 +1637,7 @@ <h4 id="contributing-building-build"><a class="link" href="#contributing-buildin
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2017-08-30 22:08:32 CEST
+Last updated 2017-09-01 00:11:08 CEST
 </div>
 </div>
 <link rel="stylesheet" href="highlight/styles/github.min.css">
diff --git a/spring-auto-restdocs-docs/constraints.adoc b/spring-auto-restdocs-docs/constraints.adoc
index 5e670e69..3731654e 100644
--- a/spring-auto-restdocs-docs/constraints.adoc
+++ b/spring-auto-restdocs-docs/constraints.adoc
@@ -7,6 +7,30 @@ Here we are going a step further and automatically use constraints
 and the constraint groups to derive whether a field is optional
 and to add the constraint descriptions to the field descriptions.
 
+.Example
+[source,java]
+----
+/**
+ * Username
+ */
+@NotNull
+@Size(min = 2, max = 50)
+private String username;
+----
+
+.Result
+|===
+|Parameter|Type|Optional|Description
+
+| username
+| String
+| false
+| Username.
+
+Size must be between 2 and 50.
+
+|===
+
 [[constraints-optionality]]
 === Constraint that determine optionality
 
diff --git a/spring-auto-restdocs-docs/getting-started.adoc b/spring-auto-restdocs-docs/getting-started.adoc
index 3d223b7a..a7433ceb 100644
--- a/spring-auto-restdocs-docs/getting-started.adoc
+++ b/spring-auto-restdocs-docs/getting-started.adoc
@@ -127,6 +127,7 @@ The directories are processed in order and only the first found JSON file is use
 . Configure MockMvc
 +
 [source,java]
+.Test class
 ----
 @Autowired
 private WebApplicationContext context;
@@ -174,6 +175,8 @@ public void setUp() throws Exception {
 [[gettingstarted-sample]]
 === Sample application
 
-https://github.com/ScaCap/spring-auto-restdocs/tree/master/spring-auto-restdocs-example[This project] includes a sample application that demonstrates most features:
+https://github.com/ScaCap/spring-auto-restdocs/tree/master/spring-auto-restdocs-example[This project]
+includes a sample application that demonstrates most features.
 
-The generated documentation of the example project can be viewed https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/master/spring-auto-restdocs-example/generated-docs/index.html[here].
+The generated documentation of the example project can be viewed
+https://htmlpreview.github.io/?https://github.com/ScaCap/spring-auto-restdocs/blob/master/spring-auto-restdocs-example/generated-docs/index.html[here].
diff --git a/spring-auto-restdocs-docs/index.adoc b/spring-auto-restdocs-docs/index.adoc
index 8cb3403a..be749f4e 100644
--- a/spring-auto-restdocs-docs/index.adoc
+++ b/spring-auto-restdocs-docs/index.adoc
@@ -46,11 +46,11 @@ Is Jackson required for automatic field documentation?::
   Yes, this project only includes a Jackson visitor so far.
 Is a multi-module project setup supported?::
   The JSON doclet and the REST Docs snippets produce files.
-  Therefore, all results can be copied across modules or projects.
-  Instead of copying, multiple source directories for
-  the JSON files can be configured with the `javadocJsonDir` property.
-  Directories are separated by `,` and are processed in order
-  and only the first found JSON file is used.
+  Therefore, all files should be placed on the filesystem.
+  JSON files files will be additionally looked up from classpath,
+  so modularization of codebase is fully supported.
+  For advanced customization, multiple source directories for the JSON files
+  can be configured (see <<gettingstarted-usage,usage>>).
 
 include::getting-started.adoc[]
 
@@ -58,4 +58,6 @@ include::snippets.adoc[]
 
 include::constraints.adoc[]
 
+include::other.adoc[]
+
 include::contributing.adoc[]
diff --git a/spring-auto-restdocs-docs/other.adoc b/spring-auto-restdocs-docs/other.adoc
new file mode 100644
index 00000000..3390e72d
--- /dev/null
+++ b/spring-auto-restdocs-docs/other.adoc
@@ -0,0 +1,26 @@
+:master-dir: https://github.com/ScaCap/spring-auto-restdocs/blob/master
+:example-dir: {master-dir}/spring-auto-restdocs-example
+:core-package: {master-dir}//spring-auto-restdocs-core/src/main/java/capital/scalable/restdocs
+:restdocs-package: https://github.com/spring-projects/spring-restdocs/blob/master/spring-restdocs-core/src/main/java/org/springframework/restdocs
+
+[[other]]
+== Other
+
+[[paging]]
+=== Paging support
+
+Paging support in an endpoint is automatically recognized if request handler method contains `Pageable` parameter
+and response is of type `Page`. This is then mentioned in request and response snippets by linking
+to common section explaining the details of supported paging parameters/fields.
+This section have to be created manally and must be tagged as `\[[overview-pagination]]`.
+See example project for link:{example-dir}/src/main/asciidoc/index.adoc#overview-pagination[paging section] template.
+
+[[preprocessors]]
+=== Preprocessors
+
+Preprocessors are available for use in order to improve the quality of endpoint examples.
+
+- link:{core-package}/response/BinaryReplacementContentModifier.java[binary replacement]: replaces content with `<binary>` for common mime types
+- link:{core-package}/response/ArrayLimitingJsonContentModifier.java[limit json array length]: limits all arrays in json to 3 items
+
+For list of standard preprocessors see link:{restdocs-package}//operation/preprocess/Preprocessors.java[Preprocessors].
diff --git a/spring-auto-restdocs-docs/section-snippet.adoc b/spring-auto-restdocs-docs/section-snippet.adoc
index f56a8a5a..68a34551 100644
--- a/spring-auto-restdocs-docs/section-snippet.adoc
+++ b/spring-auto-restdocs-docs/section-snippet.adoc
@@ -1,5 +1,3 @@
-:core-dir: https://github.com/ScaCap/spring-auto-restdocs/blob/master/spring-auto-restdocs-core
-:core-package: {core-dir}/src/main/java/capital/scalable/restdocs
 :restdocs-package: https://github.com/spring-projects/spring-restdocs/blob/master/spring-restdocs-core/src/main/java/org/springframework/restdocs
 
 [[snippets-section]]
diff --git a/spring-auto-restdocs-docs/snippets.adoc b/spring-auto-restdocs-docs/snippets.adoc
index e835a06e..3ddcd98d 100644
--- a/spring-auto-restdocs-docs/snippets.adoc
+++ b/spring-auto-restdocs-docs/snippets.adoc
@@ -25,7 +25,8 @@ GET /items
 [[snippets-description]]
 === Description snippet
 
-link:{core-package}/misc/DescriptionSnippet.java[Description snippet] outputs the Controller's method's Javadoc. Currently only basic `<br>` and `<p>` tags are supported.
+link:{core-package}/misc/DescriptionSnippet.java[Description snippet] outputs the Controller's method's Javadoc.
+Currently only basic `br`, `p`, `ul` and `li` tags are supported.
 
 .Code
 [source,java]
@@ -33,9 +34,11 @@ link:{core-package}/misc/DescriptionSnippet.java[Description snippet] outputs th
 /**
  * Returns list of all items.
  * <p>
- * Use query parameters to filter the list by:<br>
- * - orderNumber<br>
- * - type
+ * Use query parameters to filter the list by:
+ * <ul>
+ *   <li>orderNumber</li>
+ *   <li>type</li>
+ * </ul>
  */
 @RequestMapping...
 public ItemResponse getItems() { ... }
@@ -173,7 +176,8 @@ static class ItemUpdateRequest {
 | description
 | String
 | true
-| Item description. +
+| Item description.
+
 Size must be between 0 and 20 inclusive.
 
 |===
@@ -217,7 +221,8 @@ static class ItemResponse {
 | orderNumber
 | Integer
 | true
-| Item's order number. +
+| Item's order number.
+
 Must be at least 1.
 
 |===
diff --git a/spring-auto-restdocs-example/generated-docs/index.html b/spring-auto-restdocs-example/generated-docs/index.html
index 4424c6fb..cae0809b 100644
--- a/spring-auto-restdocs-example/generated-docs/index.html
+++ b/spring-auto-restdocs-example/generated-docs/index.html
@@ -1064,7 +1064,7 @@ <h4 id="_example_request"><a class="anchor" href="#_example_request"></a><a clas
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-bash" data-lang="bash">$ curl 'http://localhost:8080/items' -i -X POST \
     -H 'Content-Type: application/json' \
-    -H 'Authorization: Bearer 69e5d411-7c80-46ce-bd8e-eed5f95bffe5' \
+    -H 'Authorization: Bearer cf1552ed-e4a5-4a69-ac58-3ed01bf1f439' \
     -d '{"description":"Hot News"}'</code></pre>
 </div>
 </div>
@@ -1278,7 +1278,7 @@ <h4 id="_example_request_2"><a class="anchor" href="#_example_request_2"></a><a
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-bash" data-lang="bash">$ curl 'http://localhost:8080/items/1' -i -X PUT \
     -H 'Content-Type: application/json' \
-    -H 'Authorization: Bearer 69e5d411-7c80-46ce-bd8e-eed5f95bffe5' \
+    -H 'Authorization: Bearer cf1552ed-e4a5-4a69-ac58-3ed01bf1f439' \
     -d '{"description":"Hot News"}'</code></pre>
 </div>
 </div>
@@ -1376,7 +1376,7 @@ <h4 id="_example_request_3"><a class="anchor" href="#_example_request_3"></a><a
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-bash" data-lang="bash">$ curl 'http://localhost:8080/items/1' -i -X DELETE \
-    -H 'Authorization: Bearer 69e5d411-7c80-46ce-bd8e-eed5f95bffe5'</code></pre>
+    -H 'Authorization: Bearer cf1552ed-e4a5-4a69-ac58-3ed01bf1f439'</code></pre>
 </div>
 </div>
 </div>
@@ -1808,8 +1808,8 @@ <h4 id="_example_response_5"><a class="anchor" href="#_example_response_5"></a><
   },
   "total" : 1,
   "totalPages" : 1,
-  "totalElements" : 1,
   "last" : true,
+  "totalElements" : 1,
   "size" : 20,
   "number" : 0,
   "sort" : null,
@@ -2082,7 +2082,7 @@ <h4 id="_example_response_7"><a class="anchor" href="#_example_response_7"></a><
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2017-08-30 22:07:24 CEST
+Last updated 2017-08-31 23:33:47 CEST
 </div>
 </div>
 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.9.1/styles/github.min.css">

From 4b79d422fe580e54d0eecd33a433157322764943 Mon Sep 17 00:00:00 2001
From: Juraj Misur <juraj.misur@gmail.com>
Date: Fri, 1 Sep 2017 00:15:44 +0200
Subject: [PATCH 2/3] small fixes

---
 docs/index.html                                        | 8 ++++----
 spring-auto-restdocs-docs/index.adoc                   | 2 +-
 spring-auto-restdocs-docs/other.adoc                   | 4 ++--
 spring-auto-restdocs-example/generated-docs/index.html | 8 ++++----
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/index.html b/docs/index.html
index 5b07c3da..9c446dd2 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -537,7 +537,7 @@ <h2 id="faq"><a class="link" href="#faq">FAQ</a></h2>
 <p><em>Is a multi-module project setup supported?</em></p>
 <p>The JSON doclet and the REST Docs snippets produce files.
 Therefore, all files should be placed on the filesystem.
-JSON files files will be additionally looked up from classpath,
+JSON files will be additionally looked up from classpath,
 so modularization of codebase is fully supported.
 For advanced customization, multiple source directories for the JSON files
 can be configured (see <a href="#gettingstarted-usage">usage</a>).</p>
@@ -1540,7 +1540,7 @@ <h3 id="paging"><a class="link" href="#paging">Paging support</a></h3>
 <div class="sect2">
 <h3 id="preprocessors"><a class="link" href="#preprocessors">Preprocessors</a></h3>
 <div class="paragraph">
-<p>Preprocessors are available for use in order to improve the quality of endpoint examples.</p>
+<p>Preprocessors are available for use in order to improve quality of endpoint examples.</p>
 </div>
 <div class="ulist">
 <ul>
@@ -1553,7 +1553,7 @@ <h3 id="preprocessors"><a class="link" href="#preprocessors">Preprocessors</a></
 </ul>
 </div>
 <div class="paragraph">
-<p>For list of standard preprocessors see <a href="https://github.com/spring-projects/spring-restdocs/blob/master/spring-restdocs-core/src/main/java/org/springframework/restdocs//operation/preprocess/Preprocessors.java">Preprocessors</a>.</p>
+<p>For list of standard preprocessors see <a href="https://github.com/spring-projects/spring-restdocs/blob/master/spring-restdocs-core/src/main/java/org/springframework/restdocs/operation/preprocess/Preprocessors.java">Preprocessors</a>.</p>
 </div>
 </div>
 </div>
@@ -1637,7 +1637,7 @@ <h4 id="contributing-building-build"><a class="link" href="#contributing-buildin
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2017-09-01 00:11:08 CEST
+Last updated 2017-09-01 00:15:29 CEST
 </div>
 </div>
 <link rel="stylesheet" href="highlight/styles/github.min.css">
diff --git a/spring-auto-restdocs-docs/index.adoc b/spring-auto-restdocs-docs/index.adoc
index be749f4e..595efe9a 100644
--- a/spring-auto-restdocs-docs/index.adoc
+++ b/spring-auto-restdocs-docs/index.adoc
@@ -47,7 +47,7 @@ Is Jackson required for automatic field documentation?::
 Is a multi-module project setup supported?::
   The JSON doclet and the REST Docs snippets produce files.
   Therefore, all files should be placed on the filesystem.
-  JSON files files will be additionally looked up from classpath,
+  JSON files will be additionally looked up from classpath,
   so modularization of codebase is fully supported.
   For advanced customization, multiple source directories for the JSON files
   can be configured (see <<gettingstarted-usage,usage>>).
diff --git a/spring-auto-restdocs-docs/other.adoc b/spring-auto-restdocs-docs/other.adoc
index 3390e72d..af5d73af 100644
--- a/spring-auto-restdocs-docs/other.adoc
+++ b/spring-auto-restdocs-docs/other.adoc
@@ -18,9 +18,9 @@ See example project for link:{example-dir}/src/main/asciidoc/index.adoc#overview
 [[preprocessors]]
 === Preprocessors
 
-Preprocessors are available for use in order to improve the quality of endpoint examples.
+Preprocessors are available for use in order to improve quality of endpoint examples.
 
 - link:{core-package}/response/BinaryReplacementContentModifier.java[binary replacement]: replaces content with `<binary>` for common mime types
 - link:{core-package}/response/ArrayLimitingJsonContentModifier.java[limit json array length]: limits all arrays in json to 3 items
 
-For list of standard preprocessors see link:{restdocs-package}//operation/preprocess/Preprocessors.java[Preprocessors].
+For list of standard preprocessors see link:{restdocs-package}/operation/preprocess/Preprocessors.java[Preprocessors].
diff --git a/spring-auto-restdocs-example/generated-docs/index.html b/spring-auto-restdocs-example/generated-docs/index.html
index cae0809b..58356e39 100644
--- a/spring-auto-restdocs-example/generated-docs/index.html
+++ b/spring-auto-restdocs-example/generated-docs/index.html
@@ -1064,7 +1064,7 @@ <h4 id="_example_request"><a class="anchor" href="#_example_request"></a><a clas
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-bash" data-lang="bash">$ curl 'http://localhost:8080/items' -i -X POST \
     -H 'Content-Type: application/json' \
-    -H 'Authorization: Bearer cf1552ed-e4a5-4a69-ac58-3ed01bf1f439' \
+    -H 'Authorization: Bearer 199be96a-9d08-40c2-8dd2-782f8c4c7e17' \
     -d '{"description":"Hot News"}'</code></pre>
 </div>
 </div>
@@ -1278,7 +1278,7 @@ <h4 id="_example_request_2"><a class="anchor" href="#_example_request_2"></a><a
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-bash" data-lang="bash">$ curl 'http://localhost:8080/items/1' -i -X PUT \
     -H 'Content-Type: application/json' \
-    -H 'Authorization: Bearer cf1552ed-e4a5-4a69-ac58-3ed01bf1f439' \
+    -H 'Authorization: Bearer 199be96a-9d08-40c2-8dd2-782f8c4c7e17' \
     -d '{"description":"Hot News"}'</code></pre>
 </div>
 </div>
@@ -1376,7 +1376,7 @@ <h4 id="_example_request_3"><a class="anchor" href="#_example_request_3"></a><a
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-bash" data-lang="bash">$ curl 'http://localhost:8080/items/1' -i -X DELETE \
-    -H 'Authorization: Bearer cf1552ed-e4a5-4a69-ac58-3ed01bf1f439'</code></pre>
+    -H 'Authorization: Bearer 199be96a-9d08-40c2-8dd2-782f8c4c7e17'</code></pre>
 </div>
 </div>
 </div>
@@ -1808,8 +1808,8 @@ <h4 id="_example_response_5"><a class="anchor" href="#_example_response_5"></a><
   },
   "total" : 1,
   "totalPages" : 1,
-  "last" : true,
   "totalElements" : 1,
+  "last" : true,
   "size" : 20,
   "number" : 0,
   "sort" : null,

From 4441068c19049ba11bd53623014f2006cf3746e4 Mon Sep 17 00:00:00 2001
From: Juraj Misur <juraj.misur@gmail.com>
Date: Fri, 1 Sep 2017 17:17:19 +0200
Subject: [PATCH 3/3] pr feedback

---
 spring-auto-restdocs-docs/other.adoc | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/spring-auto-restdocs-docs/other.adoc b/spring-auto-restdocs-docs/other.adoc
index af5d73af..3a4571c6 100644
--- a/spring-auto-restdocs-docs/other.adoc
+++ b/spring-auto-restdocs-docs/other.adoc
@@ -12,7 +12,7 @@
 Paging support in an endpoint is automatically recognized if request handler method contains `Pageable` parameter
 and response is of type `Page`. This is then mentioned in request and response snippets by linking
 to common section explaining the details of supported paging parameters/fields.
-This section have to be created manally and must be tagged as `\[[overview-pagination]]`.
+This section has to be created manally and must be tagged as `\[[overview-pagination]]`.
 See example project for link:{example-dir}/src/main/asciidoc/index.adoc#overview-pagination[paging section] template.
 
 [[preprocessors]]
@@ -21,6 +21,6 @@ See example project for link:{example-dir}/src/main/asciidoc/index.adoc#overview
 Preprocessors are available for use in order to improve quality of endpoint examples.
 
 - link:{core-package}/response/BinaryReplacementContentModifier.java[binary replacement]: replaces content with `<binary>` for common mime types
-- link:{core-package}/response/ArrayLimitingJsonContentModifier.java[limit json array length]: limits all arrays in json to 3 items
+- link:{core-package}/response/ArrayLimitingJsonContentModifier.java[limit JSON array length]: limits all JSON arrays to 3 items
 
-For list of standard preprocessors see link:{restdocs-package}/operation/preprocess/Preprocessors.java[Preprocessors].
+For a list of standard preprocessors see link:{restdocs-package}/operation/preprocess/Preprocessors.java[Preprocessors].