Improve schemas and documentation

+ Make sure properties are displayed in preferred order in doc + Fix schemas to improve validation in IntelliJ and VSCode + Improve rendering in IntelliJ and VSCode Signed-off-by: David Gageot <david@gageot.net>
GoogleContainerTools · Feb 28, 2019 · cb6c5dc · cb6c5dc
1 parent 60173f6
commit cb6c5dc
Show file tree

Hide file tree

Showing 14 changed files with 8,223 additions and 4,438 deletions.
diff --git a/docs/content/en/docs/references/yaml/main.js b/docs/content/en/docs/references/yaml/main.js
@@ -16,21 +16,31 @@ function* template(definitions, parentDefinition, ref, ident) {
   const name = ref.replace('#/definitions/', '');
 
   let allProperties = [];
-  var properties = definitions[name].properties;
-  for (var key in properties) {
-      allProperties.push([key, properties[key]]);
+  let seen = {}
+  if (definitions[name].properties) {
+      var properties = definitions[name].properties;
+      for (var key of definitions[name].preferredOrder) {
+          allProperties.push([key, properties[key]]);
+          seen[key] = true;
+      }
   }
   if (definitions[name].anyOf) {
-      for (var properties of definitions[name].anyOf) {
-          for (var key in properties.properties) {
-              allProperties.push([key, properties.properties[key]]);
+      for (var anyOf of definitions[name].anyOf) {
+          console.log(anyOf);
+          if (anyOf.preferredOrder) {
+              for (var key of anyOf.preferredOrder) {
+                  if (!seen[key]) {
+                      allProperties.push([key, anyOf.properties[key]]);
+                      seen[key] = true;
+                  }
+              }
           }
       }
   }
 
   let index = -1
   for (var [key, definition] of allProperties) {
-    var desc = definition.description;
+    var desc = definition['x-intellij-html-description'];
     let value = definition.default;
     index++;