Merge branch 'improve-generator-documentation' of https://github.com/plantbreeding/BrAPI into improve-generator-documentation

Author: Guy Davenport

Specification/Generated/brapi_v2_1.json

@@ -15536,30 +15536,30 @@
         },
         "example" : 1000
       },
-      "pageToken" : {
-        "name" : "pageToken",
+      "page" : {
+        "name" : "page",
         "in" : "query",
-        "description" : "**Deprecated in v2.1** Please use `page`. Github issue number #451 \n<br> Used to request a specific page of data to be returned.\n<br> Tokenized pages are for large data sets which can not be efficiently broken into indexed pages. Use the nextPageToken and prevPageToken from a prior response to construct a query and move to the next or previous page respectively. ",
+        "description" : "Used to request a specific page of data to be returned.\n\nThe page indexing starts at 0 (the first page is 'page'= 0). Default is `0`.",
         "required" : false,
-        "deprecated" : true,
         "style" : "form",
         "explode" : true,
         "schema" : {
-          "type" : "string"
+          "type" : "integer"
         },
-        "example" : "33c27874"
+        "example" : "0"
       },
-      "page" : {
-        "name" : "page",
+      "pageToken" : {
+        "name" : "pageToken",
         "in" : "query",
-        "description" : "Used to request a specific page of data to be returned.\n\nThe page indexing starts at 0 (the first page is 'page'= 0). Default is `0`.",
+        "description" : "**Deprecated in v2.1** Please use `page`. Github issue number #451 \n<br> Used to request a specific page of data to be returned.\n<br> Tokenized pages are for large data sets which can not be efficiently broken into indexed pages. Use the nextPageToken and prevPageToken from a prior response to construct a query and move to the next or previous page respectively. ",
         "required" : false,
+        "deprecated" : true,
         "style" : "form",
         "explode" : true,
         "schema" : {
-          "type" : "integer"
+          "type" : "string"
         },
-        "example" : "0"
+        "example" : "33c27874"
       },
       "authorizationHeader" : {
         "name" : "Authorization",