also show an example to query by parameter value

This is the most likely scenario so it should appear first in the
documentation.

I've also modified the example command for running non-ganeti reboots so
that it directly launches the reboots and it automatically excludes
ganeti nodes.

the options were renamed to include the unit type (e.g. minutes or
seconds)

If I just copy/paste the examples from this page, I get an error like
this:

    No idea what 'perdulce.torproject.org' is!

This is because the last sed command in subshells that fetch information
is not doing what it should since output is separated by newlines
instead of spaces. With `paste` we can make this work better.

Adding an explicit token name makes it easier for people to find it again.

I feel like this is not complete, but I jotted down what I knew.

The alert was added during phase A of the migration to prometheus but I
had not written anything about how to handle those situations.

This goes with the new alert for this condition.

surely not exhaustive, but what I could think of off the top of my head.

This was succesfully performed to restore weather-01 on a test-01
server, not even hooked in Puppet.

this updates the puppet control repo proposal to account for the fact
that the repository would track an environment as opposed to /etc/puppet
altogether

it also adds to the proposal renaming hiera -> data, site-modules -> site and
adding "legacy" to the environment modulepath which would contain all
modules which still need to be either published as a public module or
transformed into a profile

note that while I've tried to retain consistency with "step 0" of
publishing our puppet code, I don't think we should maintain this goal,
let alone keep it as the very first step before everything else

Closes: team#41937