WIP

config/resources.yaml

@@ -1,3 +1,17 @@
+standard_metadata_properties:
+  - name: name
+    type: string
+    description: |
+      The name of the resource.
+  - name: namespace
+    type: string
+    description: |
+      The namespace of the resource.
+    links:
+      - name: Namespace concept
+        url: /concepts/namespace.html
+      - name: Kubernetes namespaces
+        url: ""
 groups:
   - name: Sites
     resources:
@@ -26,9 +40,6 @@ groups:
                 namespace: hello-world-west
               spec:
                 linkAccess: default
-        metadata_properties:
-          - name: name
-            required: true
         spec_properties:
           - name: linkAccess
             default: none

input/resources/connector.md

@@ -44,6 +44,31 @@ spec:
   selector: app=backend
 ~~~
 
+</section>
+
+<section>
+
+## Metadata properties
+
+- <h3 id="name">name <span class="property-info">string, required</span></h3>
+
+  The name of the resource.
+
+  | | |
+  |-|-|
+  | Platforms | Kubernetes, Docker |
+
+
+- <h3 id="namespace">namespace <span class="property-info">string, required</span></h3>
+
+  The namespace of the resource.
+
+  | | |
+  |-|-|
+  | Platforms | Kubernetes, Docker |
+  | See also | [Namespace concept]({{site_prefix}}/concepts/namespace.html), [Kubernetes namespaces]({{site_prefix}}) |
+
+
 </section>
 
 <section>

input/resources/listener.md

@@ -45,6 +45,31 @@ spec:
   host: backend
 ~~~
 
+</section>
+
+<section>
+
+## Metadata properties
+
+- <h3 id="name">name <span class="property-info">string, required</span></h3>
+
+  The name of the resource.
+
+  | | |
+  |-|-|
+  | Platforms | Kubernetes, Docker |
+
+
+- <h3 id="namespace">namespace <span class="property-info">string, required</span></h3>
+
+  The namespace of the resource.
+
+  | | |
+  |-|-|
+  | Platforms | Kubernetes, Docker |
+  | See also | [Namespace concept]({{site_prefix}}/concepts/namespace.html), [Kubernetes namespaces]({{site_prefix}}) |
+
+
 </section>
 
 <section>

input/resources/site.md

@@ -52,6 +52,31 @@ spec:
   linkAccess: default
 ~~~
 
+</section>
+
+<section>
+
+## Metadata properties
+
+- <h3 id="name">name <span class="property-info">string, required</span></h3>
+
+  The name of the resource.
+
+  | | |
+  |-|-|
+  | Platforms | Kubernetes, Docker |
+
+
+- <h3 id="namespace">namespace <span class="property-info">string, required</span></h3>
+
+  The namespace of the resource.
+
+  | | |
+  |-|-|
+  | Platforms | Kubernetes, Docker |
+  | See also | [Namespace concept]({{site_prefix}}/concepts/namespace.html), [Kubernetes namespaces]({{site_prefix}}) |
+
+
 </section>
 
 <section>

python/resources.py

@@ -106,6 +106,16 @@ def append(line=""):
 
         append("</section>")
         append()
+        append("<section>")
+        append()
+        append("## Metadata properties")
+        append()
+
+        for prop in resource.metadata_properties:
+            generate_property(prop, append)
+
+        append("</section>")
+        append()
 
     if resource.spec_properties:
         append("<section>")
@@ -260,6 +270,13 @@ class Resource(ModelObject):
     def __init__(self, model, group, data):
         super().__init__(model, group, data)
 
+        self.metadata_properties = list()
+
+        for property_data in self.model.data.get("standard_metadata_properties", []):
+            prop = Property(self.model, self, property_data, "metadata")
+
+            self.metadata_properties.append(prop)
+
         self.spec_properties = list()
         self.spec_properties_by_name = dict()
 
@@ -306,6 +323,10 @@ def __init__(self, model, resource, data, group):
 
     @property
     def required(self):
+        # XXX
+        if self.group == "metadata":
+            return True
+
         schema = self.model.get_schema(self.object)
         required_names = schema["properties"][self.group].get("required", [])
         default = self.name in required_names