From http://www.sphinx-doc.org/en/stable/domains.html#directive-option:
> The directive will create cross-reference targets for the given options,
> referencable by option (in the example case, you’d use something like
> :option:`dest_dir`, :option:`-m`, or :option:`--module`).
I don't think we're intending here to create cross references,
we simply want to render it nicely.
So just use code formatting instead.
This gets rid of the last build warnings.
As per [their blog post of the 27th April](https://blog.readthedocs.com/securing-subdomains/) ‘Securing subdomains’:
> Starting today, Read the Docs will start hosting projects from subdomains on the domain readthedocs.io, instead of on readthedocs.org. This change addresses some security concerns around site cookies while hosting user generated data on the same domain as our dashboard.
Test Plan: Manually visited all the links I’ve modified.
I've tried to describe why you would choose one method over
another, and what the relative advantages and disadvantages
are of each method.
I'm painfully aware that I haven't covered the combo of
freezing an application *then* creating a Linux distro
package of it, but maybe that's a battle for another day.
My intent is to add more content on the Freezing page
once this commit is accepted, so I can hear your feedback
before doing any further work.
Thanks.
Dan Bader
kennethreitz