Is your feature request related to a problem? Please describe.
I want to be able to define my namespaces within yaml and have the corresponding markdown generated rather than needing to define it within readme.md files within the docs folder.

Describe the solution you'd like

To be able to write a yaml file similiar to the below describes my namespace and at build time generates a markdown file for me

groups:
  - id: namespace.workflow
    type: namespace
    name: Workflow
    stability: development
    brief: 
    note:
    header:
      title:
      content:
      style:
    footer:
      title:
      content:
      style:

Or in v2

namespaces:
  - name: workflow
    stability: development
    brief: 
    note:
    header:
      message:
      type:
    footer:
      message:
      type:

It is assumed the build process could automatically add references to any groups defined in the same folder so that we would have insight into what is available and could render it.

Describe alternatives you've considered
Manually maintain the linkage in markdown and remember to update it.