Merge "Update tox.ini, enable doc8"
This commit is contained in:
commit
3a9da4e955
@ -53,9 +53,9 @@ Individual Contributors
|
|||||||
^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
#. In Gerrit's `settings <https://review.openstack.org/#/settings/agreements>`_
|
#. In Gerrit's `settings <https://review.openstack.org/#/settings/agreements>`_
|
||||||
click the **New Contributor Agreement** link and sign the agreement. You need
|
click the **New Contributor Agreement** link and sign the
|
||||||
this to contribute code & documentation. You will not be able to push patches
|
agreement. You need this to contribute code & documentation. You
|
||||||
to Gerrit without this.
|
will not be able to push patches to Gerrit without this.
|
||||||
|
|
||||||
.. image:: /_assets/account-setup/3.png
|
.. image:: /_assets/account-setup/3.png
|
||||||
:scale: 70%
|
:scale: 70%
|
||||||
|
@ -40,10 +40,12 @@ project Z. Those changes need to merge in order to complete feature A.
|
|||||||
|
|
||||||
Boards & Worklists
|
Boards & Worklists
|
||||||
------------------
|
------------------
|
||||||
Worklists and Boards are different ways of organizing work. It is up to the project
|
|
||||||
team how stories are organized. They could be sorted by milestone. A lane could
|
Worklists and Boards are different ways of organizing work. It is up
|
||||||
have all the bugs or all the new features. It depends on the teams way of organizing
|
to the project team how stories are organized. They could be sorted by
|
||||||
and coordinating work. Order of stories in a worklist could convey priority as well.
|
milestone. A lane could have all the bugs or all the new features. It
|
||||||
|
depends on the teams way of organizing and coordinating work. Order of
|
||||||
|
stories in a worklist could convey priority as well.
|
||||||
|
|
||||||
Launchpad
|
Launchpad
|
||||||
=========
|
=========
|
||||||
@ -60,27 +62,30 @@ or blueprints.
|
|||||||
Blueprints
|
Blueprints
|
||||||
----------
|
----------
|
||||||
|
|
||||||
In Launchpad, a new feature is called a blueprint. To file a new blueprint, click the
|
In Launchpad, a new feature is called a blueprint. To file a new
|
||||||
'Register a blueprint' button on the right.
|
blueprint, click the 'Register a blueprint' button on the right.
|
||||||
|
|
||||||
On the next screen you are prompted to add details including its name and title.
|
On the next screen you are prompted to add details including its name
|
||||||
|
and title.
|
||||||
|
|
||||||
.. image:: /_assets/task_tracking/LP-overview.png
|
.. image:: /_assets/task_tracking/LP-overview.png
|
||||||
:scale: 30
|
:scale: 30
|
||||||
|
|
||||||
These are different in that the name is what is used in the generated url and the
|
These are different in that the name is what is used in the generated
|
||||||
title is what displays when blueprints are listed out (name: new_ibm_driver
|
url and the title is what displays when blueprints are listed out
|
||||||
title: New IBM ISCSI Driver). The next most important part is the summary- a
|
(name: new_ibm_driver title: New IBM ISCSI Driver). The next most
|
||||||
description of the code change, where most of the details about the implementation
|
important part is the summary- a description of the code change, where
|
||||||
are. After that, there are several optional fields you may wish to fill in- a
|
most of the details about the implementation are. After that, there
|
||||||
specification url, assignee, drafter, and approver. The last two fields before
|
are several optional fields you may wish to fill in- a specification
|
||||||
registering have default values- status and propose for a sprint. For most teams,
|
url, assignee, drafter, and approver. The last two fields before
|
||||||
it is typical to leave the default values.
|
registering have default values- status and propose for a sprint. For
|
||||||
|
most teams, it is typical to leave the default values.
|
||||||
|
|
||||||
It is possible to update all of this information except the name and title after
|
It is possible to update all of this information except the name and
|
||||||
the blueprint is registered. When you have finished filling out all of the
|
title after the blueprint is registered. When you have finished
|
||||||
information you care to include, it is good to communicate with the project
|
filling out all of the information you care to include, it is good to
|
||||||
team lead that you have filed a blueprint.
|
communicate with the project team lead that you have filed a
|
||||||
|
blueprint.
|
||||||
|
|
||||||
.. image:: /_assets/task_tracking/LP-bp.png
|
.. image:: /_assets/task_tracking/LP-bp.png
|
||||||
:scale: 40
|
:scale: 40
|
||||||
@ -93,45 +98,50 @@ Bugs are pretty self explanitory- some unexpected or unintended behavior of the
|
|||||||
software. To report a bug you have found in Launchpad, click the 'Report a bug'
|
software. To report a bug you have found in Launchpad, click the 'Report a bug'
|
||||||
button from the project's overview page.
|
button from the project's overview page.
|
||||||
|
|
||||||
To get to the details of reporting the bug you fill in the summary line and click
|
To get to the details of reporting the bug you fill in the summary
|
||||||
'next'.
|
line and click 'next'.
|
||||||
|
|
||||||
.. image:: /_assets/task_tracking/LP-bug.png
|
.. image:: /_assets/task_tracking/LP-bug.png
|
||||||
:scale: 40
|
:scale: 40
|
||||||
|
|
||||||
Based on the summary line, Launchpad will do a quick query to see if there has been
|
Based on the summary line, Launchpad will do a quick query to see if
|
||||||
anything reported already that might be the same issue you are trying to report.
|
there has been anything reported already that might be the same issue
|
||||||
It is important to look through these to avoid filing duplicate bugs and creating
|
you are trying to report. It is important to look through these to
|
||||||
redundancies in the bug index. If you do not see a bug that sounds like the issue
|
avoid filing duplicate bugs and creating redundancies in the bug
|
||||||
you are reporting, you can click the 'No, I need to report a new bug' button.
|
index. If you do not see a bug that sounds like the issue you are
|
||||||
|
reporting, you can click the 'No, I need to report a new bug' button.
|
||||||
|
|
||||||
.. image:: /_assets/task_tracking/LP-bug-2.png
|
.. image:: /_assets/task_tracking/LP-bug-2.png
|
||||||
:scale: 40
|
:scale: 40
|
||||||
|
|
||||||
After clicking that button, the further information field will appear along with the
|
After clicking that button, the further information field will appear
|
||||||
'This bug is a security vulnerability' radio box. You can edit the summary line to
|
along with the 'This bug is a security vulnerability' radio box. You
|
||||||
differentiate it from the other bugs Launchpad thought it was similar to, add details
|
can edit the summary line to differentiate it from the other bugs
|
||||||
like the setup you were using, what you were doing when you hit the unexpected
|
Launchpad thought it was similar to, add details like the setup you
|
||||||
behavior, the error codes you encountered, etc.
|
were using, what you were doing when you hit the unexpected behavior,
|
||||||
|
the error codes you encountered, etc.
|
||||||
|
|
||||||
If the bug is related to a security vulnerability it is important to click the box to
|
If the bug is related to a security vulnerability it is important to
|
||||||
alert the Vulnerability Management Team to the issue. When you feel you have added
|
click the box to alert the Vulnerability Management Team to the issue.
|
||||||
all of the information needed, go ahead and submit the bug report. For more information
|
When you feel you have added all of the information needed, go ahead
|
||||||
about the full process for reporting security vulnerabilties, please continue reading
|
and submit the bug report. For more information about the full process
|
||||||
`this page <https://security.openstack.org/vmt-process.html>`_.
|
for reporting security vulnerabilties, please continue reading `this
|
||||||
|
page <https://security.openstack.org/vmt-process.html>`_.
|
||||||
|
|
||||||
.. image:: /_assets/task_tracking/LP-bug-3.png
|
.. image:: /_assets/task_tracking/LP-bug-3.png
|
||||||
:scale: 30
|
:scale: 30
|
||||||
|
|
||||||
It is a good idea to check back on the bug routinely if you aren't actively working on
|
It is a good idea to check back on the bug routinely if you aren't
|
||||||
solving it to make sure people haven't asked for more information about the issue. If
|
actively working on solving it to make sure people haven't asked for
|
||||||
someone has commented on the bug, try to respond with the details they need.
|
more information about the issue. If someone has commented on the bug,
|
||||||
|
try to respond with the details they need.
|
||||||
|
|
||||||
**Bug Status**
|
**Bug Status**
|
||||||
All bugs have a status lifecycle. They start as 'New' and move to other statuses from
|
All bugs have a status lifecycle. They start as 'New' and move to
|
||||||
there depending on what all is included in the description and if others can duplicate
|
other statuses from there depending on what all is included in the
|
||||||
the issue. Resolved statuses, meaning there is no more work to be done on the bug are:
|
description and if others can duplicate the issue. Resolved statuses,
|
||||||
'Fix Released', 'Invalid', or 'Won't Fix'.
|
meaning there is no more work to be done on the bug are: 'Fix
|
||||||
|
Released', 'Invalid', or 'Won't Fix'.
|
||||||
|
|
||||||
.. list-table::
|
.. list-table::
|
||||||
:widths: 20 100
|
:widths: 20 100
|
||||||
|
@ -4,3 +4,4 @@
|
|||||||
|
|
||||||
sphinx>=1.6.2 # BSD
|
sphinx>=1.6.2 # BSD
|
||||||
openstackdocstheme>=1.11.0 # Apache-2.0
|
openstackdocstheme>=1.11.0 # Apache-2.0
|
||||||
|
doc8>=0.6.0 # Apache-2.0
|
||||||
|
9
tox.ini
9
tox.ini
@ -1,12 +1,12 @@
|
|||||||
[tox]
|
[tox]
|
||||||
minversion = 2.0
|
minversion = 2.0
|
||||||
envlist = checkbuild
|
envlist = docs,pep8
|
||||||
skipsdist = True
|
skipsdist = True
|
||||||
|
|
||||||
[testenv]
|
[testenv]
|
||||||
usedevelop = True
|
usedevelop = True
|
||||||
setenv = VIRTUAL_ENV={envdir}
|
setenv = VIRTUAL_ENV={envdir}
|
||||||
install_command = pip install -U {opts} {packages}
|
install_command = pip install {opts} {packages}
|
||||||
deps =
|
deps =
|
||||||
-r{toxinidir}/requirements.txt
|
-r{toxinidir}/requirements.txt
|
||||||
-r{toxinidir}/test-requirements.txt
|
-r{toxinidir}/test-requirements.txt
|
||||||
@ -14,5 +14,8 @@ deps =
|
|||||||
[testenv:venv]
|
[testenv:venv]
|
||||||
commands = {posargs}
|
commands = {posargs}
|
||||||
|
|
||||||
|
[testenv:pep8]
|
||||||
|
commands = doc8 doc
|
||||||
|
|
||||||
[testenv:docs]
|
[testenv:docs]
|
||||||
commands = python setup.py build_sphinx
|
commands = sphinx-build -b html -W doc/source doc/build/html
|
||||||
|
Loading…
Reference in New Issue
Block a user