Here's a patch for the Release Notes adding another common corner-case to the list of things to beware of, plus an updated set of external links including "https://wiki.debian.org/NetworkInterfaceNames". -- JBR with qualifications in linguistics, experience as a Debian sysadmin, and probably no clue about this particular package
diff --git a/en/issues.dbk b/en/issues.dbk index 3105a90f..524f2650 100644 --- a/en/issues.dbk +++ b/en/issues.dbk @@ -150,8 +150,7 @@ information mentioned in <xref linkend="morereading"/>. <para> The alternative is to switch to a supported mechanism for enforcing the old naming scheme, such as a systemd <filename>.link</filename> - file (see <ulink url="&url-man;systemd.link"> - systemd.link(5)</ulink>). + file (see <ulink url="&url-man;systemd.link">systemd.link(5)</ulink>). The <literal>net.ifnames=0</literal> kernel commandline option might also work for systems with only one network interface (of a given type). </para> @@ -173,9 +172,10 @@ $ udevadm test-builtin net_id /sys/class/net/<replaceable>eth0</replaceable> 2>/ </screen> <para> This should give enough information to devise a migration plan. (If the - <literal>udevadm</literal> output includes an <quote>onboard</quote> - name, that takes priority; MAC-based names are normally treated as a - fallback, but may be needed for USB network hardware.) + <literal>udevadm</literal> output includes an <quote>onboard</quote> or + <quote>slot</quote> name, that takes priority; MAC-based names are + normally treated as a fallback, but may be needed for USB network + hardware.) </para> <para> Once you are ready to carry out the switch, disable @@ -194,9 +194,9 @@ $ sudo update-initramfs -u names. Adjust any remaining configuration files, and test your system. </para> <para> - See the - <ulink url="https://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames/">upstream - documentation</ulink> and the <literal>udev</literal> + See <ulink url="&url-wiki;NetworkInterfaceNames">the wiki</ulink>, <ulink + url="https://www.freedesktop.org/software/systemd/man/systemd.net-naming-scheme.html">upstream + documentation</ulink>, and the <literal>udev</literal> <filename>README.Debian</filename> for further information. </para> </section>