Changed next and previous models format. Added clarification to the detailed

error status message

docs/samples/response_get.xml

@@ -1,26 +1,37 b''
 <?xml version="1.1" encoding="UTF-8" ?>
 <response>
     <status>success</status>
     <models>
         <model name="post">
             <id>id1/1</id>
             <title>13</title>
             <text>Thirteen</text>
             <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>
             <title>13</title>
             <text>Thirteen</text>
             <pub-time>12</pub-time>
             <edit-time>13</edit-time>
             <tags>
                 <tag>tag1</tag>
             </tags>
         </model>
     </models>
 </response>

docs/samples/response_versionmismatch.xml

@@ -1,5 +1,11 b''
 <?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>