From 520876d4a1e887b525686806f911abd82c7e08e8 Mon Sep 17 00:00:00 2001 From: Kenny Johnston Date: Thu, 9 Jun 2016 11:22:24 -0500 Subject: [PATCH] Updates to HACKING.rst Updates HACKING to include mention of initial merge with robust discussion followed by subsequent merges with limited scope. Change-Id: Ief410a502e2a7221b2d05d054ccb865b9adcc52d --- HACKING.rst | 68 ++++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 49 insertions(+), 19 deletions(-) diff --git a/HACKING.rst b/HACKING.rst index 7a7513e..ce1ec7f 100644 --- a/HACKING.rst +++ b/HACKING.rst @@ -12,36 +12,66 @@ openstack-user-stories Style Commandments Product WG User Story Submission Process ---------------------------------------- -- Follow instructions at `Documentation/HowTo/FirstTimers `_ - - This page will help you configure your local environment -- Clone openstack-user-stories using "git clone https://github.com/openstack/openstack-user-stories" and create a branch using "git checkout -b " +- Follow instructions at `First Timers Documentation + `_ + + - This page will help you configure your local environment +- Clone openstack-user-stories using "git clone + https://github.com/openstack/openstack-user-stories" and create a branch + using "git checkout -b ". - Document your user story using our `approved template `_ -- Save the user story in the "user-stories" directory with a unique name -- Document relevant information about the submission in a tracker using JSON. Here is a link to the `tracker template `_ - - For more information on the tracker format, you can read the `Tracker Overview `_ -- Save the tracker file (with as much information as you are able to provide) in the "trackers" directory using the same unique name as the user-story but ending with a .json extension -- A member of the Product WG might contact you to review the submission using the email address associated with your Gerrit user. +- Save the user story in the "user-stories/proposed" directory with a unique name + + - For initial submissions of a user story expect a robust discussion around + the intent, value and content of your story + - Subsequent commits after general agreement should be more bite-sized in + conformance with `general OpenStack best practices `_. +- Document relevant information about the submission in a JSON tracker. Here is + a link to the `tracker template `_. + + - For more information on the tracker format, you can read the `Tracker + Overview `_ +- Save the tracker file (with as much information as you are able to provide) + in the "trackers" directory using the same unique name as the user-story but + ending with a .json extension +- A member of the Product WG might contact you to review the submission using + the email address associated with your Gerrit user. User Story Endorsement Process ------------------------------ -We might often have a user story in the repository that might be beneficial to multiple working groups or community members. If you find a user story that applies to you or your SIG (Special Interest Group) then please endorse the user story. Endorsement shows that the user story has importance to multiple groups and can help it earn a higher priority. +We might often have a user story in the repository that might be beneficial to +multiple working groups or community members. If you find a user story that +applies to you or your SIG (Special Interest Group) then please endorse the +user story. Endorsement shows that the user story has importance to multiple +groups and can help it earn a higher priority. - Follow instructions at `Documentation/HowTo/FirstTimers `_ - - This page will help you configure your local environment -- Clone openstack-user-stories using "git clone https://github.com/openstack/openstack-user-stories" and create a branch using "git checkout -b " + + - This page will help you configure your local environment +- Clone openstack-user-stories using "git clone + https://github.com/openstack/openstack-user-stories" and create a branch + using "git checkout -b " - Find associated tracker for the user story in the "trackers" directory -- Modify the 'supporting working groups' or 'supporting individual members' accordingly +- Modify the 'supporting working groups' or 'supporting individual members' + accordingly User Story Tracker ------------------------------ -The tracker file for the user story has to be updated once a user story has gone through the workflow and has blueprints associated with it. +The tracker file for the user story has to be updated once a user story has +gone through the workflow and has blueprints associated with it. - Follow instructions at `Documentation/HowTo/FirstTimers `_ - - This page will help you configure your local environment -- Clone openstack-user-stories using "git clone https://github.com/openstack/openstack-user-stories" and create a branch using "git checkout -b " + + - This page will help you configure your local environment +- Clone openstack-user-stories using "git + clone https://github.com/openstack/openstack-user-stories" and create a + branch using "git checkout -b " - Find associated tracker for the user story in the "trackers" directory - Modify the 'blueprints/specs' with the following information: - - Project Blueprint/Spec Pertains To - - Link to Blueprint/Spec - - Status of Blueprint/Spec -- The overall completion for a user story is determined by number of blueprints/specs in completed status versus the overall number of blueprints/specs submitted against a user story. + + - Project Blueprint/Spec Pertains To + - Link to Blueprint/Spec + - Status of Blueprint/Spec +- The overall completion for a user story is determined by number of + blueprints/specs in completed status versus the overall number of + blueprints/specs submitted against a user story.