471 Commits

Author SHA1 Message Date
Jeremy Stanley
0973f2f50b 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
2018-12-04 16:05:47 +00:00
qingszhao
8046b2e0b8 Change openstack-infra to openstack-discuss
Mailinglists have been updated. Openstack-discuss replaces openstack-infra.

Change-Id: Iafcc20ba1cfda7512c0495155cc916677298fdf0
2018-12-04 14:48:20 +00:00
Zuul
c1e2bd7d4b Merge "Replace mailing list" 2018-12-03 18:23:55 +00:00
François Magimel
78efd799aa 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
2018-12-02 19:37:52 +01:00
Jean-Philippe Evrard
934574bfa9 Replace mailing list
We should use openstack-discuss instead of openstack-dev now.

Change-Id: I63fed7bd5a53e376dc7bb3ac9259edf252d29746
2018-11-21 12:46:21 +01:00
Andreas Jaeger
4cb518e4ed 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
2018-11-02 22:29:38 +01:00
Andreas Jaeger
2302c36b8d Give encryption example
Add an example on how to encrypt a secret.

Change-Id: Ie79726677c3c3ad5204fa6c1b3d3c0dfa25d7ebb
2018-11-02 14:43:42 +01:00
Zuul
f3b2414e3d Merge "Makes documentation easier to read" 2018-10-30 18:25:51 +00:00
Zuul
77a0baf80b Merge "Mention that docs-on-readthedocs should stay in project-config" 2018-10-30 15:35:30 +00:00
Zuul
db04d966f9 Merge "Remove reference to x-vrif-minus-2" 2018-10-30 14:45:04 +00:00
Sorin Sbarnea
32d3b565b2 Makes documentation easier to read
Adds missing link that documents how to create groups.

Change-Id: Ic7cdbd3e5528b4aba601796475fff375d28300f6
2018-10-30 14:26:29 +00:00
Chris Dent
ade2fb243b 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
2018-10-30 07:45:31 +00:00
Sean McGinnis
124993dc0b
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>
2018-10-11 10:02:52 -05:00
Andreas Jaeger
80f0f31630 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
2018-09-06 16:28:05 +02:00
Zuul
e29aeb4bbf Merge "Document shared queue and policy for integrated-gate" 2018-08-28 15:48:15 +00:00
Thierry Carrez
d9239247c0 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
2018-08-28 15:56:19 +02:00
Andreas Jaeger
46c301e721 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
2018-08-24 18:49:28 +02:00
melissaml
7c0c88df63 Remove the duplicated word
Change-Id: I720e1532f177d26fbb50f00dbc612422aa60c3bd
2018-08-22 12:33:47 +08:00
Zuul
bf247fbd32 Merge "Give examples for master only jobs" 2018-08-21 13:31:21 +00:00
Zuul
9a4784325b Merge "Clarify inability to delete tags" 2018-08-21 13:26:43 +00:00
Andreas Jaeger
74b8995f7a 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
2018-08-20 14:58:00 +00:00
Andreas Jaeger
10337ad144 Give examples for master only jobs
Enhance creators guide with some examples of templates that run against
master only.

Change-Id: I6f2889de2396c7b8bbaa6b2e635279df6835fe7c
2018-08-18 19:21:43 +02:00
Andreas Jaeger
ce09c452de 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
2018-08-16 22:00:16 +02:00
Clark Boylan
d7a44a9243 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
2018-08-13 11:19:46 -07:00
Jeremy Stanley
5f64b667f6 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
2018-08-10 15:45:33 +00:00
Zuul
59da4b9e97 Merge "Remove Zuul v2 content" 2018-08-03 21:07:21 +00:00
Zuul
c7c84a69e8 Merge "Update Zuul Status Page to correct URL" 2018-08-03 20:58:00 +00:00
Zuul
fb403bf734 Merge "fix URL markup for PEP 440" 2018-08-03 20:57:10 +00:00
Anita Kuno
ddcf6f5280 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
2018-08-01 11:44:45 -04:00
Doug Hellmann
3d0ee2b496 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>
2018-07-31 16:47:28 -04:00
Zuul
815628bb9e Merge "Drop references to system-required template" 2018-07-27 13:43:25 +00:00
Andreas Jaeger
c1c47a745e 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
2018-07-27 15:30:49 +02:00
Jeremy Stanley
9f8010a339 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
2018-07-07 14:59:16 +00:00
Jeremy Stanley
64ed6e77f3 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
2018-06-29 14:44:40 +00:00
Sean McGinnis
dd45ab7c16 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
2018-06-28 13:08:52 -05:00
Monty Taylor
825006296a 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
2018-06-27 19:46:43 +02:00
Zuul
30e8f568e3 Merge "remove reference to publish-openstack-python-tarball before deleting it" 2018-06-26 18:13:22 +00:00
Clark Boylan
9235fcd97d 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
2018-06-26 10:31:52 -07:00
Doug Hellmann
0d0597f8bf 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>
2018-06-12 15:04:54 -04:00
Jens Harbott
6c805d4cbe 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
2018-06-05 09:51:07 +00:00
Jeremy Stanley
4d8f46547f 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
2018-05-29 17:08:20 +00:00
Vu Cong Tuan
9304ccb66d 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
2018-05-25 10:04:20 +07:00
Dan Radez
07b4b59756 Updating pypi links in creators.html
Change-Id: I5e3f73a5db09a440892c75a11f2d17e7cd5eb69d
Story: 2001947
2018-05-01 15:35:47 -04:00
Kendall Nelson
f84e92fb41 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
2018-04-24 15:51:50 -07:00
Zuul
25b6554c37 Merge "Update ACL sections with release team policy change" 2018-04-11 14:50:19 +00:00
Andreas Jaeger
9d897524ff 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
2018-04-11 08:09:25 +02:00
Zuul
e2f2cf5954 Merge "Mention the availability of other cookiecutter templates" 2018-04-11 06:00:26 +00:00
Zuul
69b2cb1efb Merge "Add missing -f to cookiecutter example" 2018-04-11 06:00:24 +00:00
Zuul
1afb3c9433 Merge "Add code-block for formatting to creators.rst" 2018-04-11 06:00:23 +00:00
Adam Spiers
2a6440255f 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
2018-04-10 16:57:56 +02:00