Improve the full-repository config docs, and add reference names.

Review Request #11527 — Created March 16, 2021 and submitted — Latest diff uploaded

Information

ReviewBot
release-3.0.x

Reviewers

The general documentation on configuring repositories previously was
somewhat dense. A couple of paragraphs that highlighted a bunch of
important, but somewhat buried, information, and a paragraph that had no
business being there (likely a copy/paste), since it really belonged to
the auto-fetching section.

Neither section broke down the configuration options, or really guided
users toward setting up API tokens. They expected a bit of knowledge
that users may lack.

This change redoes the documentation, breaking it up into less-dense
paragraphs, specifically calling out the supported repository types, and
providing a list of each option for the worker configuration and what's
allowed or expected for both ways of configuring repositories.

An "important" callout box was added for the information on the
repository configuration on the Review Board side, for auto-fetching of
repositories, to help make this really stand out. Example scenarios and
a pointer to RB Gateway was added. The copy of the original version of
this information was removed from the manual section.

Section headers have also been renamed to help differentiate the two,
and reference names have been added to some sections in the file.

Built the docs and read through them. Checked for spelling errors, bad
links, and build errors.

Commits

Files