Difference between revisions of "Documentation/InstallGuide"
m (→Meeting information) |
m (→Meeting information) |
||
Line 72: | Line 72: | ||
== Meeting information == | == Meeting information == | ||
− | Every two weeks (on even weeks) on Wednesday at 0100 UTC in #openstack-meeting-3 | + | Every two weeks (on even weeks) on Wednesday at 0100 UTC in #openstack-meeting-3<br/> |
− | Every two weeks (on odd weeks) on Tuesday at 1300 UTC in #openstack-meeting-3 | + | Every two weeks (on odd weeks) on Tuesday at 1300 UTC in #openstack-meeting-3 |
''NB This schedule is currently under discussion in the openstack-docs mailing list and may change.'' | ''NB This schedule is currently under discussion in the openstack-docs mailing list and may change.'' |
Revision as of 03:52, 11 November 2015
Welcome to the home page for the Install Guide Specialty Team!
Contents
About the Install Guide team
Specialty team for developing and maintaining the OpenStack Install Guide.
How to contribute
The OpenStack installation guide includes a precise series of instructions to install a complex software suite. The primary audience involves people unfamiliar with OpenStack who simply want to evaluate it with minimal hassle and frustration. To meet these requirements, we (the contributors) thoroughly test the installation guide to verify functionality prior to a release and periodically thereafter to catch minor issues, usually involving changes to packaging.
Over the last several releases, the installation guide has become mature enough that most bugs involve user error rather than problems with the installation guide. Assuming a bug involves an actual problem with the installation guide, contributing a patch, and approving that patch without further investigation (which may sometimes require testing) carries a significant risk of breaking the guide, often in obscure ways. To keep the installation guide operational, we must use the following best practices to properly triage bugs, contribute, and review patches:
Bugs
- Do not confirm or triage your own bug. Wait for someone on the installation guide sub-team to change the status or initiate a discussion about it.
- Do not confirm or triage a bug unless you can verify an actual problem with the installation guide. In some cases, the bug description provides enough information to make a quick decision, but most of the time requires discussion or testing in a lab environment prior to confirming or triaging it.
- For the most part, only members of the installation guide sub-team should triage a bug.
Patches
- Do not contribute a patch for a bug without triage status.
Reviews
- Do not vote +1/+2 or approve a patch that references a bug without triage.
- If a patch lacks reference to a bug, vote -1 and notify the contributor to correct the commit message.
- If any doubt exists with a patch, initiate discussion and/or test it in a lab environment prior to voting +1/+2 or approving it.
- For the most part, only members of the installation guide sub-team should vote +2 or approve a patch.
Examples
To improve clarity of bug triage policy and processes, please review the following bugs:
Bug | Discussion |
---|---|
1482523 |
|
1495396 |
|
1497415 |
|
1469228 |
|
1484104 |
|
1491507 1490963 |
|
1497538 |
|
1495287 |
|
1490064 |
|
Quick links
- Completed documentation specs
- Liberty install guide blueprint
- Liberty Documentation Testing - Installation Guide and Configuration Reference
Meeting information
Every two weeks (on even weeks) on Wednesday at 0100 UTC in #openstack-meeting-3
Every two weeks (on odd weeks) on Tuesday at 1300 UTC in #openstack-meeting-3
NB This schedule is currently under discussion in the openstack-docs mailing list and may change.
Install Team meeting information
Team members
- Christian Berendt, team lead; interested in migration to RST, automated testing and updating (screenshots, outputs), no preference for a distribution (can take care of Fedora/RHEL/CentOS, this is my primary set of distributions)
- Bernd Bausch, interested in more readable and complete install guides
- Pranav Salunke, interested in maintaining openSUSE, SLES sections of installa guides. Also creating tools for automated testing and making it easy to work on install guides.
- Matt Kassawara, doing this for a while now.
- Alex Adamov, Debian
- Karen Bradshaw, help convert the install guide to RST
- Harry Sutton, interested in maintaining currency and accuracy in the install guides. I work for HP in Technology Services and worry about things like serviceability.
- Brian Moss, interested in improving the guides
- Tom Fifield, fighting for the users
- Haïkel Guémar, RDO maintainer, will act as a liaison.
- Name, role/interests
Link archive
- Review: Debian install guide spec
- Review: General Liberty install guide spec (to be updated after RST conversion)