From 9616269ecfb4e712396bfd0cca97d579cf69f325 Mon Sep 17 00:00:00 2001 From: Luka Peschke Date: Thu, 25 Oct 2018 16:36:22 +0200 Subject: [PATCH] Refreshing the repository This commit aims at updating this repo, as it is intended to be used much more from now on. The README and spec template have been updated in order to remove any comments or informations about launchpad/blueprints. Change-Id: Ideaf51be8acf5e39713c8c4fa4d186c76c2ec569 Story: 2004180 Task: 27667 --- README.rst | 25 +++++++------------------ specs/template.rst | 45 ++++++++++++++++++++++----------------------- 2 files changed, 29 insertions(+), 41 deletions(-) diff --git a/README.rst b/README.rst index 575917b..f7bf178 100644 --- a/README.rst +++ b/README.rst @@ -1,10 +1,10 @@ -================================== +=================================== OpenStack Cloudkitty Specifications -================================== +=================================== This git repository is used to hold approved design specifications for additions -to the Cloudkitty project. Reviews of the specs are done in gerrit, using a similar -workflow to how we review and merge changes to the code itself. +to the Cloudkitty project. Reviews of the specs are done in gerrit, using a +similar workflow to how we review and merge changes to the code itself. The layout of this repository is:: @@ -14,24 +14,13 @@ You can find an example spec in `specs/template.rst`. Specifications are proposed for a given release by adding them to the `specs/` directory and posting it for review. The implementation -status of a blueprint for a given release can be found by looking at the -blueprint in launchpad. Not all approved blueprints will get fully implemented. +status of a story for a given release can be found by looking at the +story in Storyboard. Not all stories will get fully implemented. -Specifications have to be re-proposed for every release. The review may be +Specifications have to be re-proposed for every release. The review may be quick, but even if something was previously approved, it should be re-reviewed to make sure it still makes sense as written. -Prior to the Ocata development cycle, this repository was not used for spec -reviews. Reviews prior to Ocata were completed entirely through Launchpad -blueprints:: - - http://blueprints.launchpad.net/cloudkitty - -Please note, Launchpad blueprints are still used for tracking the -current status of blueprints. For more information, see:: - - https://wiki.openstack.org/wiki/Blueprints - For more information about working with gerrit, see:: http://docs.openstack.org/infra/manual/developers.html#development-workflow diff --git a/specs/template.rst b/specs/template.rst index 9d00a2e..332c8c6 100644 --- a/specs/template.rst +++ b/specs/template.rst @@ -4,13 +4,13 @@ http://creativecommons.org/licenses/by/3.0/legalcode -========================================== -Example Spec - The title of your blueprint -========================================== +====================================== +Example Spec - The title of your story +====================================== -Include the URL of your launchpad blueprint: +Include the URL of your Storyboard story: -https://blueprints.launchpad.net/cloudkitty/+spec/example +https://storyboard.openstack.org/#!/project_group/66 Introduction paragraph -- why are we doing anything? A single paragraph of prose that operators can understand. @@ -21,10 +21,6 @@ Some notes about using this template: * Please wrap text at 79 columns. -* The filename in the git repository should match the launchpad URL, for - example a URL of: https://blueprints.launchpad.net/cloudkitty/+spec/awesome-thing - should be named awesome-thing.rst - * Please do not delete any of the sections in this template. If you have nothing to say for a whole section, just write: None @@ -179,8 +175,8 @@ to the OpenStack Security Group at openstack-security@lists.openstack.org. Notifications Impact ---------------------------- -Please specify any changes to notifications or auditing. Be that an extra notification, -changes to an existing notification, or removing a notification. +Please specify any changes to notifications or auditing. Be that an extra +notification, changes to an existing notification, or removing a notification. Other end user impact --------------------- @@ -201,7 +197,8 @@ pattern of existing code. Examples of things to consider here include: * A periodic task might look like a small addition but when considering large - scale deployments the proposed call may in fact be performed on hundreds of nodes. + scale deployments the proposed call may in fact be performed on hundreds + of nodes. * A small change in a utility function or a commonly used decorator can have a large impacts on performance. @@ -218,8 +215,9 @@ Other deployer impact Discuss things that will affect how you deploy and configure OpenStack that have not already been mentioned, such as: -* What config options are being added? Should they be more generic than proposed? - Are the default values ones which will work well in real deployments? +* What config options are being added? Should they be more generic than + proposed? Are the default values ones which will work well in + real deployments? * Is this a change that takes immediate effect after its merged, or is it something that has to be explicitly enabled? @@ -252,17 +250,17 @@ Implementation Assignee(s) ----------- -Who is leading the writing of the code? Or is this a blueprint where you're +Who is leading the writing of the code? Or is this a story 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: - + Other contributors: - + Work Items ---------- @@ -271,12 +269,13 @@ 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. +In your Storyboard story, create one task per work item detailed here. Dependencies ============ -* Include specific references to specs and/or blueprints in Cloudkitty, or in other - projects, that this one either depends on or is related to. +* Include specific references to specs and/or stories/tasks in Cloudkitty, or + in other projects, that this one either depends on or is related to. * If this requires functionality of another project that is not currently used by Cloudkitty, document that fact. @@ -288,10 +287,10 @@ Dependencies Testing ======= -Please discuss how the change will be tested. We especially want to know what -tempest tests will be added. It is assumed that unit test coverage will be -added so that doesn't need to be mentioned explicitly, but discussion of why -you think unit tests are sufficient and we don't need to add more tempest +Please discuss how the change will be tested. Detail howe you intend to test +this (unit tests only ? with tempest ?). It is assumed that unit test coverage +will be added so that doesn't need to be mentioned explicitly, but discussion +of why you think unit tests are sufficient and we don't need to add more tempest tests would need to be included. Is this untestable in gate given current limitations (specific hardware /