diff --git a/docs/samples/response_get.xml b/docs/samples/response_get.xml
--- a/docs/samples/response_get.xml
+++ b/docs/samples/response_get.xml
@@ -9,8 +9,19 @@
             <thread>id1/12</thread>
             <pub-time>12</pub-time>
             <edit-time>13</edit-time>
-            <previous-id>id1/3,id23/5</previous-id>
-            <after-id>id2/3,id43/5</after-id>
+            <!--
+                Next and previous are the links to sequential models.
+                In the case of an image board, next are replies and previous
+                are the posts we replied to.
+            -->
+            <previous>
+                <id>id1/3</id>
+                <id>id23/5</id>
+            </previous>
+            <next>
+                <id>id2/3</id>
+                <id>id43/5</id>
+            </next>
         </model>
         <model name="post">
             <id>id1/2</id>
diff --git a/docs/samples/response_versionmismatch.xml b/docs/samples/response_versionmismatch.xml
--- a/docs/samples/response_versionmismatch.xml
+++ b/docs/samples/response_versionmismatch.xml
@@ -1,5 +1,11 @@
 <?xml version="1.1" encoding="UTF-8" ?>
 <response>
     <status>error</status>
+    <!--
+         The detail field reply cases are limited. They are optional to
+         check, so the implementation can check the status, see 'error' and
+         just drop the response and not check the details. This is the main
+         reason detail was split to another field.
+    -->
     <status-detail>protocol version mismatch</status-detail>
 </response>