Run script generate-gitmodules.py to sync with governace repository to
add new repositories and remove retired ones.
Change-Id: Ia42b717ad242958ba4a9689ac814c956f460712f
* Update infra-manual from branch 'master'
- Merge "Move Translation setup to i18n document"
- Move Translation setup to i18n document
The translation setup is OpenStack specific, move it to the i18n
repository.
Depends-On: https://review.opendev.org/711826
Change-Id: I5919bb97527f343fbbf7a01e836cbe607f460e35
* Update infra-manual from branch 'master'
- Merge "Remove OpenStack specific steps from project retirement/rename"
- Remove OpenStack specific steps from project retirement/rename
For Retirement:
Two of the 5 steps are OpenStack specific, remove them.
For rename: Some instructions are OpenStack specific, remove them.
Change https://review.opendev.org/712534 adds these steps to the
project-team-guide.
Change-Id: I8c1aca854512ebcee54fc5c203ed3a0336ab1a05
* Update infra-manual from branch 'master'
- Merge "Update Feature branches, releases sections for OpenStack"
- Update Feature branches, releases sections for OpenStack
Remove OpenStack specific content, the Project Team Guide covers this.
Rework to have a common "Branches" section and then go into feature and
stable branches and have this generic for OpenDev projects.
Change-Id: I6169ca0414ae818dca1751b863f98517c043903e
* Update infra-manual from branch 'master'
- Merge "Remove section "Updating devstack-vm-gate-wrap.sh""
- Remove section "Updating devstack-vm-gate-wrap.sh"
This section is not relevant anymore, new repos should not use
devstack-gate. Remove it.
Change-Id: I6291f8c5dcaf22e64437a7de1a06ceaf4911fd52
* Update infra-manual from branch 'master'
- Fix Peer Review section formatting
https://docs.openstack.org/infra/manual/developers.html#peer-review is
wrongly formatted, remove the extra indent that makes it preformatted
instead of a list.
Change-Id: I842814aa916bc8116c8889638d2a907214441da9
* Update infra-manual from branch 'master'
- Merge "Update "Code Review" for OpenDev"
- Update "Code Review" for OpenDev
Generalize content for OpenDev, mark OpenStack specifics as such.
Fix description of +A button.
Change-Id: I39db553fc29f94f7ec9bc7c90f715573f85d51d7
* Update infra-manual from branch 'master'
- Merge "Remove "Eligibility to Vote in Elections" section"
- Remove "Eligibility to Vote in Elections" section
Remove this OpenStack specific section, it's migrated now to the
OpenStack Contributor Guide.
See also https://review.opendev.org/711531
Change-Id: I42f2110e0956b5b5c68225fde1e081cef1a7bbca
* Update infra-manual from branch 'master'
- Merge "Update "Outbound Third-Party Testing" for OpenDev"
- Update "Outbound Third-Party Testing" for OpenDev
Update this section for OpenDev.
Update Zuul App instructions as well, this is now in OpenDev.
Use https everywhere in the section.
Change-Id: Idf347e858849aad9504293bacc32ae3d455f7ec0
* Update infra-manual from branch 'master'
- Merge "Update sandbox intro for OpenDev"
- Update sandbox intro for OpenDev
Rephrase a sentence for move from OpenStack to OpenDev.
Change-Id: Ieea9dc653782653cc5f1e160b685932dbfbc6d6e
* Update infra-manual from branch 'master'
- Merge "Document why drafts are disabled"
- Document why drafts are disabled
Not everyone knows the history here so give some breadcrumbs.
Change-Id: Ic9045ebbf9c480775e3ccbcfddaa9f4da51e65dc
* Update infra-manual from branch 'master'
- Merge "Update elastic-recheck comment"
- Update elastic-recheck comment
The Contributor Guide talks about e-r already, let's link to that and
remove the extra information.
Change-Id: Ife971bc0b1d471858f2c6a5a5bea4d6b2acdc32d
* Update infra-manual from branch 'master'
- Merge "Update Driver's Guide for OpenDev"
- Update Driver's Guide for OpenDev
This is a first iteration over the guide to update obvious places for
the transition from OpenStack infrastructure to OpenDev.
Change-Id: I723c680b7a9eddd80969ff00ccfe499e10222551
* Update infra-manual from branch 'master'
- Update Developer's Guide for OpenDev
This is a first iteration to update the low-hanging fruits for going
from OpenStack to OpenDev.
Change-Id: Ib9c7274800485487cd5a67a55256eed30d28ed72
* Update infra-manual from branch 'master'
- Merge "List other Contributor Guides"
- List other Contributor Guides
Generate a first list of other Contributor guides so that people know
where to get more information about e.g. OpenStack specifics.
Change-Id: I04fe86a282bcd5571234dd492975050019ca763d
* Update infra-manual from branch 'master'
- Merge "Rework README.rst for OpenDev"
- Rework README.rst for OpenDev
Update the text to make it less OpenStack specific and focused on
OpenDev.
Change-Id: Id2a4fd14f3c0c7d6535f64106e5f4ec9b6749759
* Update infra-manual from branch 'master'
- Merge "OpenDev Update for Creator's Guide"
- OpenDev Update for Creator's Guide
This is a first iteration on making the Creator's Guide ready for
OpenDev. The whole file needs some more sections moved out, let's tackle
those separately.
It removes the section "Updating devstack-vm-gate-wrap.sh" since that is
not needed anymore.
Remove section "Add Project to the Requirements List" since the syncing
is not done anymore.
Change-Id: Idd949b3459cb136391abea8039d44ee80e8b1992
* Update infra-manual from branch 'master'
- Merge "Update python files for OpenDev"
- Update python files for OpenDev
Update Python files for move to OpenDev.
Update openstackdocstheme also to newer version and remove
now obsolete comments.
Remove unused sections from setup.cfg.
Change-Id: I2184e381f587c2630e514e44fa9a9f3bbc4d65e2
* Update infra-manual from branch 'master'
- Merge "Point to Zuul docs for configuring jobs"
- Point to Zuul docs for configuring jobs
We are now well past the zuulv3 migration and don't need to continue
carrying specific documentation for that transition. Instead we can
point people directly to the Zuul documentation.
Change-Id: I0965ef2de95700e466c30de412f0317d0554641c
* Update infra-manual from branch 'master'
- Merge "Improve job naming convention docs"
- Improve job naming convention docs
We are now well past the Zuulv2 -> v3 transition and the old v2 context
is likely not very useful for many of our users. Improve the job naming
convention docs to remove transition specific suggestions and instead
simply provide a set of rules that work for our current Zuul deployment.
Change-Id: Ifc069d366cd7fd27c4bbc2b3331c78a6477659a1
* Update infra-manual from branch 'master'
- Merge "Update testing for OpenDev"
- Update testing for OpenDev
This is a minimal update, it leaves a few places still mentioning
OpenStack, infrastructure related text is updated for OpenDev.
Remove "clean check" section, this is moved to Contributor Guide.
Depends-On: https://review.opendev.org/711319
Change-Id: I092944b38ff7402107bf4ff67cffa752e350a0e4
* Update infra-manual from branch 'master'
- Merge "Remove python manual page"
- Remove python manual page
This page is basically a redirect, let's remove it. The page
was changed in 2015 to point to the Project Team Guide, so it should
really not be needed.
Change-Id: I8b18b89c3df4e9014c632614e6813de3cbe8ee16
* Update infra-manual from branch 'master'
- Merge "Update core.rst for two +2 policy"
- Update core.rst for two +2 policy
Two +2s is a policy by some projects that is not enforced, update the
approval section for this.
Change-Id: Ibf569f17444d4d9512d53ef90f2a075f6a093125
* Update infra-manual from branch 'master'
- Merge "Cleanup Gerrit Approval event note"
- Cleanup Gerrit Approval event note
The note here about how Gerrit Approval events are emitted was true for
older Gerrit. Current Gerrit (including the one we are running) emits
the event details on all events which fixes this problem for us.
Change-Id: Iedde959407c1ea214d4616f71d89468a85109a0b
* Update infra-manual from branch 'master'
- Merge "opendev: Update index page"
- opendev: Update index page
Update main page to prepare this document for OpenDev.
Change-Id: I0739158e6d5c7eefe871bd580ee23cf48bc27c7d
* Update infra-manual from branch 'master'
- Rewrite logs.o.o post reference
The instructions for getting logs of post jobs is not correct anymore,
rewrite the section.
Change-Id: I280b520db95648bccfffaf16b801de9b715c2ecc
* Update infra-manual from branch 'master'
- translation: drop babel extractor definitions
babel extractors are now registered via python entry points,
so there is no need to declare babel extractors in babel configs.
This allows us to switch the message extractor easily.
For example, the horizon team plans to switch the babel extractor
from django-babel to enmerkar (a fork of django-babel) near future
as django-babel does not work with Django 2.2 (the recent LTS of Django)
and looks unmaintained for over two years.
Change-Id: I4580aa4b0f1ba2f6fd4dcaa3510b665ca5a77024
* Update infra-manual from branch 'master'
- Mention TC resolution on moving projects out of openstack
Update "renaming a project" to mention the recent TC resolution on how
to handle moves out of openstack namespace.
Change-Id: I83d9a89f9230e79f963cc546c084684d6cb884ae
* Update infra-manual from branch 'master'
- Document "clean check" requirement
This is from a IRC discussion and slightly reworked.
Change-Id: I11d72daf04b2d72424b5b3f00507b7b0a9590583
Co-Authored-By: Jeremy Stanley <fungi@yuggoth.org>
Co-Authored-By: Clark Boylan <clark.boylan@gmail.com>
* Update infra-manual from branch 'master'
- Merge "Clarify need for two Zuul changes during creation"
- Clarify need for two Zuul changes during creation
Make it more apparent that the "Add Project to Zuul" and "Add Jobs
for your project" steps in the Creators Guide require separate
changes even if they're both for the project-config repo.
Change-Id: I5564120993e195f1393901d4abcc0170e0a1dab3
* Update infra-manual from branch 'master'
- Merge "Fix the link to the openSUSE's git-review package"
- Fix the link to the openSUSE's git-review package
Change-Id: I74ea906422e71809b3252a4e9c353970c0f033d8
* Update infra-manual from branch 'master'
- Merge "Update .gitreview wording in retire process"
- Update .gitreview wording in retire process
We had a note in the repo retirement process regarding steps to take
before removing the .gitreview file. Later we determined that it is best
to keep that file in the repo rather than removing it, but the note
mentioning its removal was kept after other wording updates noting it
should stay.
This removes the removal reference and updates the notes about keeping
the file to attempt to make things more clear.
Change-Id: Id4ee69de31569645c3486f7b8508db3d6e64da8f
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
* Update infra-manual from branch 'master'
- Document git repo mirroring
Document how a project can publish content to any git mirror like
github.
This is copied from
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/005007.html
and adopted.
Change-Id: I521c63c439c8e547f2d92a887343e56686a87e0c
Co-Authored-By: David Moreau Simard <dmsimard@redhat.com>
* Update infra-manual from branch 'master'
- Merge "Follow rename of sandbox repos"
- Follow rename of sandbox repos
The sandbox repos moved from openstack-dev to opendev, follow the rename
in our docs.
Also, fix a few other remains of the OpenDev rename.
Depends-On: https://review.opendev.org/657277
Change-Id: I31d0c806964083ccddd8d63ac63f22f82859620a
* Update infra-manual from branch 'master'
- Update infra-specs URL
The site moved, update only link from this repo to infra-specs.
Fix building: Use python3 for docs environment since newer sphinx
requires python3.
Change-Id: I0db0a753e17d671ee64ea7a87e065c958dd94850
* Update infra-manual from branch 'master'
- Update for OpenDev Gerrit changes
Use new URLs and project organizations everywhere.
Change-Id: I2a5fb17c5ec1cb76693bf55ff25ffda6cc84759e
- OpenDev Migration Patch
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:
http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.htmlhttp://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html
Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.
* Update infra-manual from branch 'master'
- Improve the details about settings i18n for new repos
- explicitely point out that babel.cfg needs to be created also
for pure Python projects and provide a minimal version of it;
- fix the name of the job template which provides translation
jobs and describe the possible templates.
Change-Id: I70891d0538bf0daa0720b72bcb1539b43a252800
- Fix some URL redirections and broken links
Use the new format of PyPI links.
Use the Zuul domain name for Zuul doc links.
Fix broken links (Oslo docs, Storyboard) or broken bookmarks.
Change-Id: I4bfb63bf99c8528494d73f5f50018a2636b5bc37
- Revert "Change openstack-infra to openstack-discuss"
This reverts commit 8046b2e0b8bce3d5296e6396367ad63bfb623c1e.
The openstack-infra mailing list is still in use and was not merged into openstack-discuss.
Change-Id: I489cf427b92f35fb9e450f6dd1107794bdea2b56
- Change openstack-infra to openstack-discuss
Mailinglists have been updated. Openstack-discuss replaces openstack-infra.
Change-Id: Iafcc20ba1cfda7512c0495155cc916677298fdf0
- Merge "Replace mailing list"
- Fix a reST block syntax
There was a typo in the reST syntax of a block. And the quote character
was replaced with an apostrophe to avoid coloring.
Change-Id: I6701b3d30b166bc55bd51b1913ba22c3b0199ce7
- Replace mailing list
We should use openstack-discuss instead of openstack-dev now.
Change-Id: I63fed7bd5a53e376dc7bb3ac9259edf252d29746
- Fix link to publish-to-pypi
Don't link to publish-to-pypi-python3, link to publish-to-pypi.
We're removing publish-to-pypi-python3, let's link to the real template.
Change-Id: Ib6541c42f2cd470bf948146314eab74270cfd440
- Give encryption example
Add an example on how to encrypt a secret.
Change-Id: Ie79726677c3c3ad5204fa6c1b3d3c0dfa25d7ebb
- Merge "Makes documentation easier to read"
- Merge "Mention that docs-on-readthedocs should stay in project-config"
- Merge "Remove reference to x-vrif-minus-2"
- Makes documentation easier to read
Adds missing link that documents how to create groups.
Change-Id: Ic7cdbd3e5528b4aba601796475fff375d28300f6
- Add info on needing publish-to-pypi template
The "Tagging a Release" section is easy to find with internet
searches, and in isolation can be misleading without additional
information on needing a publish-to-pypi template associated
with the project wanting to do a release. This adds that
information with some links to additional info.
Change-Id: I2b9eeb327db032e4173628398d9003b5f221ae76
- Remove reference to x-vrif-minus-2
This channel notification is a noop and is in the process of being
replaced with a newly named notification. To prevent it being used for
new gerritbot updates by those that are not aware of this, this removes
it from the example announce example.
Change-Id: I448d8ed7d14fad96b7c9c125b541b27dd838098a
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
- Mention that docs-on-readthedocs should stay in project-config
The template triggers job on release, so should stay in project-config.
Change-Id: I1accdbd747731fa398a55e9ecfe03eb308d73dd2
- Merge "Document shared queue and policy for integrated-gate"
- Add details around initial .zuul.yaml addition
Instructions around adding the initial .zuul.yaml file did not
make it clear that the file should not preexist, and that the file
should really be added as the first change after the repository
was accepted and created.
Change-Id: Ia6b79c6f6688f021c569a38c9d9b80eab2b00e9b
- Document shared queue and policy for integrated-gate
The integrated-gate queue should stay in project-config as a policy.
Document this and briefly document shared queues in general.
Change-Id: I71900ff7fc65795b6c4743a38d185308992ad6fa
- Remove the duplicated word
Change-Id: I720e1532f177d26fbb50f00dbc612422aa60c3bd
- Merge "Give examples for master only jobs"
- Merge "Clarify inability to delete tags"
- Clarify project creation now that jobs are in-repo
Update a section that still spoke about two changes for project-config -
we only need one now. But still two changes are needed for running jobs.
Change-Id: I3e1c71c83485f3fafb86d7046f15c351c092e23e
- Give examples for master only jobs
Enhance creators guide with some examples of templates that run against
master only.
Change-Id: I6f2889de2396c7b8bbaa6b2e635279df6835fe7c
- Improve Central Config Exception description
Add list of example templates that are tag based.
Fix formatting, initial whitespace renders a grey bar that is not
wanted.
Change-Id: I4c61e83370f776972977aaac431f6ac4c011fa4f
- Push PTI job config into projects
The Infra team would like to avoid needing to review every PTI job
related update to openstack projects. Make it clear that it is ok for
projects to manage this config in repo so that they can manage and
review it themselves. This takes advantage of the new shiny features
that Zuul v3 provides in a way that should make both infra and
individual projects happier.
Change-Id: I51bd6c5bbcb8135c3ea4fed6941613643a3bcead
- Clarify inability to delete tags
Add a warning to the tagging workflow in the Developer's Guide that
pushed tags can't really be deleted, and also extend the section on
tagging an initial release in the Creator's Guide to include a
pointer to the detailed tagging workflow so that readers don't
mistake it for our more thorough directions.
Change-Id: Ic6faf8ec93a357a4316966120a9aae0af21c39cd
- Merge "Remove Zuul v2 content"
- Merge "Update Zuul Status Page to correct URL"
- Merge "fix URL markup for PEP 440"
- Add IRC Nick Registration to Developer Docs
As of Aug 1, 2018 all channels require users to register their
nicks. Add this information to the developer docs.
Change-Id: Iae8deb3b32ca8babd9942bbe047fd309d704dd27
- fix URL markup for PEP 440
The markup for the link to PEP-440 does not have a trailing _ so the
RST is bleeding into the rendered HTML. Fix this by replacing the
long-form URL markup with Sphinx's "pep" role.
Change-Id: Ia38217722f8303f00c133049f0942342e95dee24
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
- Merge "Drop references to system-required template"
- Remove Zuul v2 content
Remove a now obsolete section, this is covered in the Zuul v3 guide.
Leave a link to it in there so that the audience - project drivers -
find it.
Remove now obsolete naming from of project from in-repo .zuul.yaml file.
Change-Id: Iba3ae53a56cb0d20e7edab3bcba72f9724232274
- There are no core developers, only core reviewers
Our community has insisted in the past that "core developers" aren't
a thing, so if we want to avoid continued propagation of that
terminology then we should do our best to eradicate it in official
documents.
Change-Id: I50b9d3e889f00f3e09f7bd0a81dfc2c267f085d3
- Drop references to system-required template
Our Zuul configuration examples no longer need to mention the
system-required template since we apply it globally using a regular
expression match on project names.
Change-Id: I302d9e8708249a50704d6ffe317b2df653c8e618
- Add note about project read-only step for unretirement
Manual step is required when unretiring a project. Add a note so we
don't have to remember this next time.
Change-Id: Ic02860a423a35a2b1d6c50e0983b12c2d97f9f46
- Remove system-required instructions for creators
With the wildcard application of system-required, we no longer need to
make people do the system-required patch dance when creating a project.
They still need a job defined somewhere before they can land patches,
so, let's document this and give only in-tree as example.
Change-Id: I0f8878901ce0302c89a40b9190dd806b2f5a85e8
Depends-On: https://review.openstack.org/577307
- Merge "remove reference to publish-openstack-python-tarball before deleting it"
- Add note about test env MTU variance
We can't rely on interface MTUs of 1500 in test envs. Some clouds give
us smaller MTUs due to overlay networking. Explain that test jobs that
create or modify networking interfaces or bridges should check for and
accomodate this.
Change-Id: Ice6c613108f3f01042ff6f4e8c88a8f0a326c815
- remove reference to publish-openstack-python-tarball before deleting it
The job isn't used, so I will delete it, but wanted to update the
documentation reference first.
Change-Id: Ic08e914be065ff9f4ec6b489c9d1d9915ff284f8
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
- Mention keywords to highlight tech support
We have defined special keywords that allow people to highlight OpenStack
Infra team members when needed, mention these in our IRC document.
Change-Id: I7461c065c32984e574a57c674b3cf880966def8e
- Correct old reference to StackForge hosting guide
The original document to which this was linking got renamed and
previous references to StackForge removed. Reflect it in the Infra
Manual as well.
Change-Id: I37f5445eca3eb3ccf72158db04020418134a5220
- Update Zuul Status Page to correct URL
Current URL of Zuul Status Page in code is:
http://status.openstack.org/zuul/
The correct URL must be:
https://zuul.openstack.org/
Change-Id: Ica1fbb373715cea0666b812984b16d448aaccff3
- Updating pypi links in creators.html
Change-Id: I5e3f73a5db09a440892c75a11f2d17e7cd5eb69d
Story: 2001947
* Update infra-manual from branch 'master'
- Update Launchpad mentions to StoryBoard
In an effort to stop creating Launchpad projects
that will someday need to be migrated to StoryBoard,
remove mentions of Launchpad from Project Creator guide
and instead tell new projects how to start tracking
work in StoryBoard.
Story: 2000876
Task: 6343
Change-Id: Ibec66e8dd952ea33a2f84578e41b33d5afab4451
* Update infra-manual from branch 'master'
- Merge "Update ACL sections with release team policy change"
- Update ACL sections with release team policy change
Official teams are managed by the Release Management team, they
create branches and tags.
Explain how ACLs for these should be setup.
Change-Id: I0dfb14b60ae96f9d1777ce5ce8782e6e94eaaa50
Depends-On: https://review.openstack.org/557737
* Update infra-manual from branch 'master'
- Merge "Mention the availability of other cookiecutter templates"
- Mention the availability of other cookiecutter templates
The specs template is likely to be commonly used, so mention that
explicitly. Other cookiecutter templates are added from time to time,
so rather than relying on keeping this documentation in sync with the
full list, provide a URL from which the full list can be obtained
dynamically.
Change-Id: I0e8bf1fe54012614e5846f4611f79f40da0df5aa
* Update infra-manual from branch 'master'
- Merge "Add missing -f to cookiecutter example"
- Add missing -f to cookiecutter example
All other cookiecutter examples use "-f", add it to the last one as
well.
Change-Id: I4769f6cb0bbed75558e19d613ef2d7946ae13634
* Update infra-manual from branch 'master'
- Merge "Add code-block for formatting to creators.rst"
- Add code-block for formatting to creators.rst
Give Sphinx some hints on what format we have so that syntax highlighting will
work better with adding code-block for examples and shell code.
Indent two code blocks for consistency.
Add one missing "$" for consistency.
Change-Id: Id71fa3052e3c88835d27fff9d97c1b6c16a03723
Andreas Jaeger