Update rest.js (github#27791)

gracepark · lucascosti · web-flow · commit 344001b359a3 · 2022-05-19T00:12:33.000Z
* Update rest.js

* Update rest.js

* Update tests/rendering/rest.js

Co-authored-by: Lucas Costi &lt;lucascosti@users.noreply.github.com&gt;

Co-authored-by: Lucas Costi &lt;lucascosti@users.noreply.github.com&gt;
diff --git a/tests/rendering/rest.js b/tests/rendering/rest.js
@@ -78,6 +78,6 @@ function formatErrors(differences) {
     }
   }
   errorMessage +=
-    'This means the categories and subcategories in the content/rest directory do not match the decorated files in lib/static/decorated directory from the OpenAPI schema. Please run `./script/rest/update-files.js --decorate-only` and push up the file changes with your updates.\n'
+    'If you have made changes to the categories or subcategories in the content/rest directory, either in the frontmatter or the structure of the directory, you will need to ensure that it matches the operations in the OpenAPI description. For example, if an operation is available in GHAE, the frontmatter versioning in the relevant docs category and subcategory files also need to be versioned for GHAE. If you are adding category or subcategory files to the content/rest directory, the OpenAPI dereferenced files must have at least one operation that will be shown for the versions in the category or subcategory files. If this is the case, it is likely that the description files have not been updated from github/github yet. Please contact  #docs-engineering or #docs-apis-and-events if you need help.\n'
   return errorMessage
 }

Original file line number	Diff line number	Diff line change
`@@ -78,6 +78,6 @@ function formatErrors(differences) {`
`78`	`78`	`}`
`79`	`79`	`}`
`80`	`80`	`errorMessage +=`
`81`		- 'This means the categories and subcategories in the content/rest directory do not match the decorated files in lib/static/decorated directory from the OpenAPI schema. Please run `./script/rest/update-files.js --decorate-only` and push up the file changes with your updates.\n'
	`81`	+ 'If you have made changes to the categories or subcategories in the content/rest directory, either in the frontmatter or the structure of the directory, you will need to ensure that it matches the operations in the OpenAPI description. For example, if an operation is available in GHAE, the frontmatter versioning in the relevant docs category and subcategory files also need to be versioned for GHAE. If you are adding category or subcategory files to the content/rest directory, the OpenAPI dereferenced files must have at least one operation that will be shown for the versions in the category or subcategory files. If this is the case, it is likely that the description files have not been updated from github/github yet. Please contact #docs-engineering or #docs-apis-and-events if you need help.\n'
`82`	`82`	`return errorMessage`
`83`	`83`	`}`