From 1e2ca741265bac489a2f969dfed8498bb286764e Mon Sep 17 00:00:00 2001
From: Liam Young <liam.young@canonical.com>
Date: Wed, 10 Nov 2021 13:23:38 +0000
Subject: [PATCH] Open Yoga specs

Change-Id: I1ac5964b3adda8696e791ff369283137f386dcb3
---
 doc/source/index.rst                          |   1 +
 doc/source/specs/wallaby/approved             |   1 -
 doc/source/specs/xena/index.rst               |  16 +--
 doc/source/specs/yoga/approved                |   1 +
 doc/source/specs/yoga/backlog                 |   1 +
 doc/source/specs/yoga/implemented             |   1 +
 doc/source/specs/yoga/index.rst               |  33 +++++
 doc/source/specs/yoga/redirects               |   1 +
 doc/source/specs/yoga/template.rst            | 125 ++++++++++++++++++
 .../ceph-dashboard.rst                        |   0
 .../{backlog => implemented}/cinder-lvm.rst   |   6 +-
 .../controlled-service-restarts.rst           |   0
 .../openstack-load-balancer.rst               |   0
 specs/yoga/approved/.keep                     |   0
 .../approved/memory-fragmentation-tuning.rst  |   0
 .../ncc-migration-ssh-auth-sharing.rst        |   9 +-
 .../backlog/audit-middleware.rst              |   0
 .../backlog/ceph-storage-action.rst           |   0
 .../backlog/cinder-backup-swift.rst           |   0
 .../backlog/numa-live-migration.rst           |   0
 .../release-notes-migration-to-reno.rst       |   0
 .../backlog/service-discovery.rst             |   0
 .../swift-extended-cluster-operations.rst     |   0
 specs/yoga/implemented/.keep                  |   0
 specs/yoga/redirects                          |   0
 25 files changed, 172 insertions(+), 23 deletions(-)
 delete mode 120000 doc/source/specs/wallaby/approved
 create mode 120000 doc/source/specs/yoga/approved
 create mode 120000 doc/source/specs/yoga/backlog
 create mode 120000 doc/source/specs/yoga/implemented
 create mode 100644 doc/source/specs/yoga/index.rst
 create mode 120000 doc/source/specs/yoga/redirects
 create mode 100644 doc/source/specs/yoga/template.rst
 rename specs/xena/{approved => implemented}/ceph-dashboard.rst (100%)
 rename specs/xena/{backlog => implemented}/cinder-lvm.rst (94%)
 rename specs/xena/{backlog => implemented}/controlled-service-restarts.rst (100%)
 rename specs/xena/{backlog => implemented}/openstack-load-balancer.rst (100%)
 create mode 100644 specs/yoga/approved/.keep
 rename specs/{xena => yoga}/approved/memory-fragmentation-tuning.rst (100%)
 rename specs/{xena => yoga}/approved/ncc-migration-ssh-auth-sharing.rst (97%)
 rename specs/{xena => yoga}/backlog/audit-middleware.rst (100%)
 rename specs/{xena => yoga}/backlog/ceph-storage-action.rst (100%)
 rename specs/{xena => yoga}/backlog/cinder-backup-swift.rst (100%)
 rename specs/{xena => yoga}/backlog/numa-live-migration.rst (100%)
 rename specs/{xena => yoga}/backlog/release-notes-migration-to-reno.rst (100%)
 rename specs/{xena => yoga}/backlog/service-discovery.rst (100%)
 rename specs/{xena => yoga}/backlog/swift-extended-cluster-operations.rst (100%)
 create mode 100644 specs/yoga/implemented/.keep
 create mode 100644 specs/yoga/redirects

diff --git a/doc/source/index.rst b/doc/source/index.rst
index 445dd56..560f8e3 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -11,6 +11,7 @@ Here you can find the specs, and spec template, for each release:
    :glob:
    :maxdepth: 1
 
+   specs/yoga/index
    specs/xena/index
    specs/wallaby/index
    specs/victoria/index
diff --git a/doc/source/specs/wallaby/approved b/doc/source/specs/wallaby/approved
deleted file mode 120000
index d55f949..0000000
--- a/doc/source/specs/wallaby/approved
+++ /dev/null
@@ -1 +0,0 @@
-../../../../specs/wallaby/approved
\ No newline at end of file
diff --git a/doc/source/specs/xena/index.rst b/doc/source/specs/xena/index.rst
index 03df685..3bdf042 100644
--- a/doc/source/specs/xena/index.rst
+++ b/doc/source/specs/xena/index.rst
@@ -15,19 +15,5 @@ Xena implemented specs:
    :glob:
    :maxdepth: 1
 
+   implemented/*
 
-Xena approved (but not implemented) specs:
-
-.. toctree::
-   :glob:
-   :maxdepth: 1
-
-   approved/*
-
-Xena backlog (carried over from previous cycle) specs:
-
-.. toctree::
-   :glob:
-   :maxdepth: 1
-
-   backlog/*
diff --git a/doc/source/specs/yoga/approved b/doc/source/specs/yoga/approved
new file mode 120000
index 0000000..c21cdee
--- /dev/null
+++ b/doc/source/specs/yoga/approved
@@ -0,0 +1 @@
+../../../../specs/yoga/approved
\ No newline at end of file
diff --git a/doc/source/specs/yoga/backlog b/doc/source/specs/yoga/backlog
new file mode 120000
index 0000000..882bfb1
--- /dev/null
+++ b/doc/source/specs/yoga/backlog
@@ -0,0 +1 @@
+../../../../specs/yoga/backlog/
\ No newline at end of file
diff --git a/doc/source/specs/yoga/implemented b/doc/source/specs/yoga/implemented
new file mode 120000
index 0000000..ce6e8e0
--- /dev/null
+++ b/doc/source/specs/yoga/implemented
@@ -0,0 +1 @@
+../../../../specs/yoga/implemented
\ No newline at end of file
diff --git a/doc/source/specs/yoga/index.rst b/doc/source/specs/yoga/index.rst
new file mode 100644
index 0000000..bced459
--- /dev/null
+++ b/doc/source/specs/yoga/index.rst
@@ -0,0 +1,33 @@
+=============================
+Charm Yoga Specifications
+=============================
+
+Template:
+
+.. toctree::
+   :maxdepth: 1
+
+   Specification Template (Yoga release) <template>
+
+Yoga implemented specs:
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+
+Yoga approved (but not implemented) specs:
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   approved/*
+
+Yoga backlog (carried over from previous cycle) specs:
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   backlog/*
diff --git a/doc/source/specs/yoga/redirects b/doc/source/specs/yoga/redirects
new file mode 120000
index 0000000..7bd4b16
--- /dev/null
+++ b/doc/source/specs/yoga/redirects
@@ -0,0 +1 @@
+../../../../specs/yoga/redirects
\ No newline at end of file
diff --git a/doc/source/specs/yoga/template.rst b/doc/source/specs/yoga/template.rst
new file mode 100644
index 0000000..bcf1944
--- /dev/null
+++ b/doc/source/specs/yoga/template.rst
@@ -0,0 +1,125 @@
+..
+  Copyright <YEARS> <HOLDER>  <--UPDATE THESE
+
+  This work is licensed under a Creative Commons Attribution 3.0
+  Unported License.
+  http://creativecommons.org/licenses/by/3.0/legalcode
+
+..
+  This template should be in ReSTructured text. Please do not delete
+  any of the sections in this template.  If you have nothing to say
+  for a whole section, just write: "None". For help with syntax, see
+  http://sphinx-doc.org/rest.html To test out your formatting, see
+  http://www.tele3.cz/jbar/rest/rest.html
+
+===============================
+The Title of Your Specification
+===============================
+
+Introduction paragraph -- why are we doing anything?
+
+Problem Description
+===================
+
+A detailed description of the problem.
+
+Proposed Change
+===============
+
+Here is where you cover the change you propose to make in detail. How do you
+propose to solve this problem?
+
+If this is one part of a larger effort make it clear where this piece ends. In
+other words, what's the scope of this effort?
+
+What versions of the operating system are affected or required?
+
+What versions of OpenStack are affected or required?
+
+What version of Juju is required?
+
+Alternatives
+------------
+
+This is an optional section, where it does apply we'd just like a demonstration
+that some thought has been put into why the proposed approach is the best one.
+
+Implementation
+==============
+
+Assignee(s)
+-----------
+
+Who is leading the writing of the code? Or is this a blueprint where you're
+throwing it out there to see who picks it up?
+
+If more than one person is working on the implementation, please designate the
+primary author and contact.
+
+Primary assignee:
+  <launchpad-id or None>
+
+Can optionally list additional ids if they intend on doing substantial
+implementation work on this blueprint.
+
+Gerrit Topic
+------------
+
+Use Gerrit topic "<topic_name>" for all patches related to this spec.
+
+.. code-block:: bash
+
+    git-review -t <topic_name>
+
+Work Items
+----------
+
+Work items or tasks -- break the feature up into the things that need to be
+done to implement it. Those parts might end up being done by different people,
+but we're mostly trying to understand the timeline for implementation.
+
+Repositories
+------------
+
+Will any new git repositories need to be created?
+
+Identify all new charm repos, interface repos, layer repos, whether new or
+existing, which will be affected or involved directly in the work which is
+defined by this spec.
+
+Documentation
+-------------
+
+Will this require a documentation change?  If so, which documents?
+Will it impact developer workflow?  Will additional communication need
+to be made?
+
+Identify the surface area of doc updates explicitly, ie. charm-guide,
+deployment-guide, charm README, wiki page links.
+
+Security
+--------
+
+Does this introduce any additional security risks, or are there
+security-related considerations which should be discussed?
+
+Testing
+-------
+
+What tests will be available or need to be constructed in order to
+validate this?  Unit/functional tests, development
+environments/servers, etc.
+
+Are there any special hardware requirements to test this?
+
+Dependencies
+============
+
+- Include specific references to specs and/or stories, or in
+  other projects, that this one either depends on or is related to.
+
+- Does this feature require any new library or program dependencies
+  not already in use?
+
+- What are the plans to package and distribute the payload and/or
+  dependencies?
diff --git a/specs/xena/approved/ceph-dashboard.rst b/specs/xena/implemented/ceph-dashboard.rst
similarity index 100%
rename from specs/xena/approved/ceph-dashboard.rst
rename to specs/xena/implemented/ceph-dashboard.rst
diff --git a/specs/xena/backlog/cinder-lvm.rst b/specs/xena/implemented/cinder-lvm.rst
similarity index 94%
rename from specs/xena/backlog/cinder-lvm.rst
rename to specs/xena/implemented/cinder-lvm.rst
index aa32d3b..e7ab86e 100644
--- a/specs/xena/backlog/cinder-lvm.rst
+++ b/specs/xena/implemented/cinder-lvm.rst
@@ -9,7 +9,7 @@
 Cinder subordinate charm cinder-lvm
 ===================================
 
-Problem description
+Problem Description
 ===================
 
 Cinder has a great number of drivers for different backends. Almost all
@@ -53,10 +53,10 @@ Assignee(s)
 -----------
 
 Primary assignee:
-    Andre Ruiz <andre.ruiz@canonical.com> - Launchpad ID: andre-ruiz
+    Andre Ruiz <andre.ruiz@canonical.com> - LP ID: andre-ruiz
 
 Secondary assignee:
-    Luciano Lo Giudice <luciano.logiudice@canonical.com> - Launchpad ID: lmlogiudice
+    Luciano Lo Giudice <luciano.logiudice@canonical.com> - LP ID: lmlogiudice
 
 Gerrit Topic
 ------------
diff --git a/specs/xena/backlog/controlled-service-restarts.rst b/specs/xena/implemented/controlled-service-restarts.rst
similarity index 100%
rename from specs/xena/backlog/controlled-service-restarts.rst
rename to specs/xena/implemented/controlled-service-restarts.rst
diff --git a/specs/xena/backlog/openstack-load-balancer.rst b/specs/xena/implemented/openstack-load-balancer.rst
similarity index 100%
rename from specs/xena/backlog/openstack-load-balancer.rst
rename to specs/xena/implemented/openstack-load-balancer.rst
diff --git a/specs/yoga/approved/.keep b/specs/yoga/approved/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/specs/xena/approved/memory-fragmentation-tuning.rst b/specs/yoga/approved/memory-fragmentation-tuning.rst
similarity index 100%
rename from specs/xena/approved/memory-fragmentation-tuning.rst
rename to specs/yoga/approved/memory-fragmentation-tuning.rst
diff --git a/specs/xena/approved/ncc-migration-ssh-auth-sharing.rst b/specs/yoga/approved/ncc-migration-ssh-auth-sharing.rst
similarity index 97%
rename from specs/xena/approved/ncc-migration-ssh-auth-sharing.rst
rename to specs/yoga/approved/ncc-migration-ssh-auth-sharing.rst
index 9901996..c7ca7fe 100644
--- a/specs/xena/approved/ncc-migration-ssh-auth-sharing.rst
+++ b/specs/yoga/approved/ncc-migration-ssh-auth-sharing.rst
@@ -12,9 +12,9 @@
   http://sphinx-doc.org/rest.html To test out your formatting, see
   http://www.tele3.cz/jbar/rest/rest.html
 
-================================================================================
-Sharing SSH authentication credentials across cloud-compute-related applications
-================================================================================
+======================================================================
+Sharing SSH auth credentials across cloud-compute-related applications
+======================================================================
 
 Some cloud environments require different configuration settings
 (e.g. allocation ratios) for different hosts, yet still need to allow
@@ -108,7 +108,8 @@ Primary assignee:
 Gerrit Topic
 ------------
 
-Use Gerrit topic "migration-ssh-auth-sharing" for all patches related to this spec.
+Use Gerrit topic "migration-ssh-auth-sharing" for all patches related to this
+spec.
 
 .. code-block:: bash
 
diff --git a/specs/xena/backlog/audit-middleware.rst b/specs/yoga/backlog/audit-middleware.rst
similarity index 100%
rename from specs/xena/backlog/audit-middleware.rst
rename to specs/yoga/backlog/audit-middleware.rst
diff --git a/specs/xena/backlog/ceph-storage-action.rst b/specs/yoga/backlog/ceph-storage-action.rst
similarity index 100%
rename from specs/xena/backlog/ceph-storage-action.rst
rename to specs/yoga/backlog/ceph-storage-action.rst
diff --git a/specs/xena/backlog/cinder-backup-swift.rst b/specs/yoga/backlog/cinder-backup-swift.rst
similarity index 100%
rename from specs/xena/backlog/cinder-backup-swift.rst
rename to specs/yoga/backlog/cinder-backup-swift.rst
diff --git a/specs/xena/backlog/numa-live-migration.rst b/specs/yoga/backlog/numa-live-migration.rst
similarity index 100%
rename from specs/xena/backlog/numa-live-migration.rst
rename to specs/yoga/backlog/numa-live-migration.rst
diff --git a/specs/xena/backlog/release-notes-migration-to-reno.rst b/specs/yoga/backlog/release-notes-migration-to-reno.rst
similarity index 100%
rename from specs/xena/backlog/release-notes-migration-to-reno.rst
rename to specs/yoga/backlog/release-notes-migration-to-reno.rst
diff --git a/specs/xena/backlog/service-discovery.rst b/specs/yoga/backlog/service-discovery.rst
similarity index 100%
rename from specs/xena/backlog/service-discovery.rst
rename to specs/yoga/backlog/service-discovery.rst
diff --git a/specs/xena/backlog/swift-extended-cluster-operations.rst b/specs/yoga/backlog/swift-extended-cluster-operations.rst
similarity index 100%
rename from specs/xena/backlog/swift-extended-cluster-operations.rst
rename to specs/yoga/backlog/swift-extended-cluster-operations.rst
diff --git a/specs/yoga/implemented/.keep b/specs/yoga/implemented/.keep
new file mode 100644
index 0000000..e69de29
diff --git a/specs/yoga/redirects b/specs/yoga/redirects
new file mode 100644
index 0000000..e69de29