Merge pull request #65 from handrews/reorg-reg

Organize registries, improve names

Author: handrews

_config.yml

@@ -18,36 +18,43 @@ collections:
     name: Format Registry
     output: true
     permalink: /registry/:collection/:title
+    order: 20
   media-type:
     slug: media-type
     name: Media Type Registry
     output: true
     permalink: /registry/:collection/:title
+    order: 40
   extension:
+    order: 10
     slug: extension
-    name: Specification Extension Registry
+    name: Extension Field Registry
     output: true
     permalink: /registry/:collection/:title
   draft-feature:
     slug: draft-feature
     name: Draft Features Registry
     output: true
     permalink: /registry/:collection/:title
+    order: 50
   alternative-schema:
     slug: alternative-schema
     name: Alternative Schema Type Registry
     output: true
     permalink: /registry/:collection/:title
+    order: 100
   namespace:
+    order: 12
     slug: namespace
-    name: Extension Namespace Registry
+    name: Extension Field Namespace Registry
     output: true
     permalink: /registry/:collection/:title
   tag-kind:
     slug: tag-kind
     name: Tag Kind Registry
     output: true
     permalink: /registry/:collection/:title
+    order: 30
 exclude:
   - Gemfile
   - Gemfile.lock

api/registries.json

@@ -2,7 +2,8 @@
 title: Registries API
 parent: API
 ---
+{% assign registries = site.collections | sort: 'order' %}
 [
-{% for collection in site.collections %}{% unless collection.hidden %}"{{ collection.slug }}"{% unless forloop.last %}{% comment %}hoping the last registry is not hidden{% endcomment %},{% endunless %}
+{% for registry in registries %}{% unless registry.hidden %}"{{ registry.slug }}"{% unless forloop.last %}{% comment %}hoping the last registry is not hidden{% endcomment %},{% endunless %}
 {% endunless %}{% endfor %}
 ]

index.md

@@ -24,5 +24,7 @@ Each specification page lists all published specification versions and official
 The [Registry Page](./registry/index.html) includes documentation as well as API and RSS access for all registries
 
 Registry shortcuts:
-{% for registry in site.collections %}{% unless registry.hidden %}
+
+{% assign registries = site.collections | sort: 'order' %}
+{% for registry in registries %}{% unless registry.hidden %}
 * <a href="registry/{{ registry.slug }}">{{ registry.name }}</a>{% endunless %}{% endfor %}

registry/index.md

@@ -13,12 +13,13 @@ Please raise a [Pull-Request](https://github.com/OAI/spec.openapis.org/pulls) ag
 
 ### Contents
 
-{% for registry in site.collections %}{% unless registry.hidden %}
+{% assign registries = site.collections | sort: 'order' %}
+{% for registry in registries %}{% unless registry.hidden %}
 * <a href="./{{ registry.slug }}">{{ registry.name }}{% endunless %}{% endfor %}
 
 #### API access
 
-* [registries.json](../api/registries.json) - Registries meta-registry{% for registry in site.collections %}{% unless registry.hidden %}
+* [registries.json](../api/registries.json) - Registries meta-registry{% for registry in registries %}{% unless registry.hidden %}
 * <a href="../api/{{ registry.slug }}.json">{{ registry.slug }}.json</a>{% endunless %} {% endfor %}
 
 #### RSS feed

rss/feed.xml

@@ -1,14 +1,15 @@
 ---
 layout: none
 ---
+{% assign registries = site.collections | sort: 'order' %}
 <?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
   <channel>
     <title>{{ site.title | xml_escape }}</title>
     <description>{{ site.description | xml_escape }}</description>
     <link>{{ site.url }}{{ site.baseurl }}/</link>
     <atom:link href="{{ "/rss/feed.xml" | prepend: site.baseurl | prepend: site.url }}" rel="self" type="application/rss+xml" />
-    {% for reg in site.collections %}
+    {% for reg in registries %}
       {% if reg.output %}
         {% assign name = reg.label %}
         {% for value in reg.docs %}