Update campaign docs to include examples and YAML reference

Created by: mrnugget

This adds back the examples we previously had, adopted to the new campaign specs.

Where and how the examples are referenced follows what was proposed in https://github.com/sourcegraph/sourcegraph/pull/10921 but temporarily removed.

Edit:

It also does a bunch of other things, like making the wording clearer, etc.