Add prose about why someone might want to contribute to keystone and
reduce the emphasis on developer-specific contributions.
Change-Id: Ied32aac47e098d25fd9880a12c617574d5e24ace
Our tools noticed that keystone links to
https://docs.openstack.org/keystone/latest/admin/identity-domain-specific-config.html
which does not exist anymore.
The page was removed but the link to it was not changed. Replace this
and similar links with internal links that will work even if files are
moved - and can be verified, thus sphinx will error in case of broken
targets.
These changes include a few other fixes for broken keystone links, e.g.
to renamed anchors.
For the include files in admin/configuration.rst and
admin/federation/configure_federation.rst: Rename them to *inc.
The files were
published twice (as separate files and on this page) and thus
referencing failed. Renaming avoids this.
Also, put doctree outside of html tree so that it does not get
published.
Change-Id: I3d07637b0046cc88a66bcb51a0a4fe7c146c1549
During the Train PTG, the team discussed ways to better engage
newcomers and folks who don't have fulltime responsibility upstream.
One way we can do that is by doing a better job describing and
applying `low-hanging-fruit` in bug triage.
This commit attempts to introduce consistency for that specific bug
tag.
Change-Id: Ib6ea0b62ad95335ed2d9b26687708cd664bf3648
We see a lot of very small patches from new contributors to do things
like fix typos, correct grammar, switch to HTTPS URLs, and similar
trivial changes. Many of these changes are technically correct, but the
value they provide to the project is very low. Assuming the best of
intentions, the obvious conclusion is that these contributors very much
want to help, but don't know where to start and haven't been given
proper guidance.
This patch introduces a new guide that lists some ongoing tasks that we
always want help with. These should be tasks that someone with no
historical context in the keystone project should be able to pick up,
but by starting a few steps above typo fixes will be able to learn
enough to eventually make more significant contributions. When typo fix
patches come in, we can use this guide to gently encourage new people to
make more valuable contributions.
Change-Id: I2a003bbef3ffbde1818fddcb840905eac6f0618c