At some point, the Gerrit WebUI ceased displaying SSH host key
details, so go ahead and bake them into our Developer's Guide and
cross-link to them from the appropriate part of the Getting Started
chapter too.
While we're here, add a link from Getting Started to the Developer's
Guide section on the OpenStack ICLA, as users following these
instructions may see errors about that when trying to set up to
contribute to a repository which enforces it.
Change-Id: I9ea5cc9952a0fd4a2bd45fd0ba3e97f8acc7b920
If you can't remove your owner-user, it means you didn't give
openstackci owner access. Make the docs explicitly say that.
Change-Id: Iadb8f2f4061bab374a00951e00e5ca45c83c144a
This corrects the ratio to match the image and reduce the squishing
effect. The new numbers represent half the size of the original image,
rounded to the nearest whole number.
Change-Id: I0639dda347df10cff256aa2ccc47ec736378472e
Fix the broken URL to Zuul's documentation on secrets and switch to
recommending the zuul-client utility instead of the deprecated
encrypt_secret.py script.
Change-Id: I508b32011a128a76344265a1ba511d6613a7f393
Test Environment hasn't been touched in a while and needs a bit of a
refresh to reflect changes to our systems in recent years as well as
removing some OpenStackisms and a bit of rewording in places for
added clarity.
Change-Id: I69156ed7ef88d9584638d59825d44f982d0cf4b4
For years now, Warehouse (PyPI) has supported automatic project
registration on initial upload. The reason our "registration"
instructions got so complicated, in fact, is that they discouraged
and then entirely stopped supporting any other method of project
registration in order to help curb namesquatting. OpenStack's
release automation has support for this workflow as well, so let's
stop being part of the problem.
Depends-On: https://review.opendev.org/852574
Change-Id: I00a72fd330a24f548b9c87cab852cf3f57d5e910
In Ia426ea36b4e6877fdce5725ff1e00ae02c62e3f4 we switched from
pushSignedTag to creaeSignedTag in all our Gerrit project ACLs, so
update examples in our documentation accordingly. The old syntax is
no longer allowed by our ACL linter.
Change-Id: Ie7cca062844101a685befe3b4f5d868b9506c5c0
In particular be more specific about us not mirroring certain sites like
PyPi, but just cache accesses.
Signed-off-by: Dr. Jens Harbott <harbott@osism.tech>
Change-Id: I3fc4856b39a4561450b666cb9c381814cd0dd9a3
Nick registration is no longer required to join the channels we
manage, but it's still a good idea. Since OFTC does provide a few
words on the process, add some sentences linking to that.
Change-Id: I744844a9a9e134dfddf2f170059a8b51563ecde1
We moved our services to OFTC at the end of May, 2021. Update all
old Freenode references in the manual, and also drop mention of
registering nicks as this is not currently required to join channels
we serve.
Change-Id: Icd9005802c891d3637ac13804b36aa960b616a2c
The new Polymer-based Gerrit WebUI has rearranged a number of
options, labels and general terminology. Revise the Drivers Guide
section on Branch Creation to match what users see now. Also refer
to Gerrit's documentation about the create reference permission, as
well as its REST API and CLI branch creation alternatives. Remove
misleading references to creation via git push, and instead indicate
that does not work.
Change-Id: I5aff0911677be1e0300728f63fb6a1ab02d30362
The redirects from docs.o.o are to README.rst, not README.md - always
speak about README.rst in the retirment instructions.
Change-Id: I50f3e677d62d94b2ff791531290c3e73c3f86109
We ask to link all changes with depends-on/needed-by -and then say "Wait
here". Let's write that clearer.
Change-Id: Id77c3aa1d6268ea5236f673df610584c846f97f0
We need our users to know that all branches will be imported and that
the repository cannot have any Zuul configuration.
Change-Id: I19faa9c0671a2121364b4607c80daf268a73f286
The OpenDev community has a new service discussion list and has also
moved to a new IRC channel. Update the contact information in the
manual to be more current.
Change-Id: I2c4f5e65e2e6f3c066d1bc6225661acc690ef945
Now that the Developer's Guide is directly linked to from the
opendev.org webpage, start with a brief introduction of the
steps necessary to interact with it, rather than comprehensive
(and intimidating) reference documentation.
Change-Id: If9244c1819ab38676466d821be0b5104b6852c47
We are trying to make this documentation less openstack specific. We
should stop using the openstack sphinx theme as a result. Use alabaster
is it is nice and clean and allows us to set our logo.
Change-Id: Icb772f6a52803af53ece419cc3908bdd8e2faad0
Change I0965ef2de95700e466c30de412f0317d0554641c removed the Zuul v3
Migration Guide, and with it our user documentation about handling
and using Zuul secrets. Add these back to appropriate sections of
the manual, slightly revised for their new contexts.
Change-Id: I63dc4711e81bec5325889e1b6c678399f846ed69
The repo got moved from openstack/infra-manual to opendev/infra-manual,
update .gitreview for this.
Change-Id: I9c82e490bc3109857f1c410ec33a37c6a8e2a8ad
Update places that speak about openstack/infra-manual to
opendev/infra-manual.
Depends-On: https://review.opendev.org/712149
Change-Id: I1aec34fd66fa1093ed41cadd017bbe3fcb5753b4
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
The translation setup is OpenStack specific, move it to the i18n
repository.
Depends-On: https://review.opendev.org/711826
Change-Id: I5919bb97527f343fbbf7a01e836cbe607f460e35
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
Remove this OpenStack specific section, it's migrated now to the
OpenStack Contributor Guide.
See also https://review.opendev.org/711531
Change-Id: I42f2110e0956b5b5c68225fde1e081cef1a7bbca