Following the upstream documentation for systemd network target:
https://www.freedesktop.org/wiki/Software/systemd/NetworkTarget/
It is not supposed to be used as an active unit and it cannot be started
directly. Quote from the website:
Note that network.target is a passive unit: you cannot start it directly
and it is not pulled in by any services that want to make use of the
network. Instead, it is pulled in by the network management service
itself. Services using the network should hence simply place an
After=network.target dependency in their unit files, and avoid any
Wants=network.target or even Requires=network.target.
This patch changes the documentation to follow the upstream
recommendation.
- Place a large caution box at the top of the file, warning
users of the outdated information on the page and directing
them to the more current "Using firewalld" quick doc.
- Drop the second and third iptables section partials entirely,
as it's been years since either 'system-config-firewall' or
'system-config-firewall-tui' has been available in the repos.
Locally it rendered for me with the title of the target document, however when
deployed it rendered with the filename of the target document. So include the
document titles explicitly instead.
* Improve messaging regarding N->N+2 upgrades.
* Move some details regarding Rawhide issues to the specific Rawhide wiki page.
This generic guide doesn't need to go into detail about Rawhide issues,
because that makes it harder to read for general users (not interested in
Rawhide). Power users can follow a link.
* Update gnome-software screenshot (more recent, with graphics).
* Clearly state that upgrading using pure `dnf` or `fedora-upgrade` is
unsupported.
* Other small adjustments and clarifications, link fixes. Make section headlines
look consistent across articles (don't capitalize every word).
The current version of the page includes hardcoded, obsolete references
to e.g. Fedora 28, 30, and 31, which can be confusing.
Replace references with attributes, and add a new one, `{NEXTNEXTVER}`
for the branched example.
Signed-off-by: Michel Alexandre Salim <salimma@fedoraproject.org>
