[Product] Please start putting user stories into our repository

Shamail Tahir itzshamail at gmail.com
Mon Aug 17 01:31:52 UTC 2015


Hi everyone,

The openstack-user-stories repository is now online and the initial
structure has also been created.  Please try to move any user stories that
you may have created and stored in the google folder to the repository
before our midcycle this coming week.  We can continue to use the external
tracker for now (therefore you can skip creating a tracker file inside the
repo).  I have included instructions on how to submit the user stories
below, please feel free to email me if you need additional help.


*Repo: https://github.com/openstack/openstack-user-stories
<https://github.com/openstack/openstack-user-stories>*
*Template: https://github.com/openstack/openstack-user-stories/blob/master/user-story-template.rst
<https://github.com/openstack/openstack-user-stories/blob/master/user-story-template.rst>*

1) Install Linux somewhere (I used Ubuntu Trusty, so the instructions below
are based on Ubuntu)
2) sudo apt-get update (steps 3 through 5 are included on the Doc/FirstTimers
page <https://wiki.openstack.org/wiki/Documentation/HowTo/FirstTimers>)
3) sudo apt-get install git AND sudo apt-get install git-review
4) setup git parameters

git config --global user.name "Firstname Lastname"
git config --global user.email name at youremail.com
git config --global gitreview.username yourgerritusername

4) You can use "git config --list" to verify if your information is setup
accurately
5) If you have to setup your SSH keys in gerrit (review.openstack.org >
login > click on your username > settings)

$ ssh-keygen –t rsa

$ less ~/.ssh/id_rsa.pub

Copy the public key data into Gerrit Account > Settings > SSH Public Keys >
"Add Key"
6) Once your key has been uploaded you can start the commit process...
7) git clone https://github.com/openstack/openstack-user-stories.git
8) create a branch for your changes using "git checkout -b <user specified
branch name>"
9) Copy the user-story template and put it into the user-stories directory
with a unique name

$ cd openstack-user-stories
$ cp user-story-template user-stories/<new_name_of_file>.rst

10) Modify the new file using your preferred editor and save it... the file
is in RST (ReStructed Text) format.
11) While in the openstack-user-stories/user-stories directory, issue a git
--add <file> command to include the file in your commit
12) git commit -a
13) git review -v

*You can also reading
the https://github.com/openstack/openstack-user-stories/blob/master/HACKING.rst
<https://github.com/openstack/openstack-user-stories/blob/master/HACKING.rst>
file
for a high-level description of the steps.*

If you need to respond to changes then you will need to follow steps in this
section
<https://wiki.openstack.org/wiki/Documentation/HowTo/FirstTimers#Respond_to_requests>
.

-- 
Thanks,
Shamail Tahir
t: @ShamailXD
tz: Eastern Time


More information about the Product-wg mailing list