wOn Mon, 2021-06-14 at 06:25 +0100, Justin B Rye wrote:
> Paul Gevers wrote:
> > + <section id="no-longer-supported-hardware">
> > + <title>Hardware that's no longer supported</title>
>
> The contraction "that's" seems out of place in a title - probably we
> should just use:
>
> <title>No longer supported hardware</title>
>
That would correctly be spelt with hyphens:
No-longer-supported hardware
> > + <para>
> > + Due to hardware limitations, it's no longer viable for Debian
> > + to build the <literal>Linux</literal> kernel supporting a
> > + number of armel based devices that were supported in
> > + buster. The unsupported devices are:
>
> This sounds as if it's talking about one kernel supporting multiple
> armel-based devices; if it means one kernel per device, that's plural.
We've used only a single kernel flavour (marvell) for these devices
since before the stretch release.
[...]
> > + Users of those platforms that wish to upgrade to bullseye
> > + nevertheless should keep the buster APT sources enabled and,
> > + before upgrading, add an APT preferences file containing
> > + something like:
>
> Users of these platforms who wish to upgrade to bullseye
> nevertheless should keep the buster APT sources enabled, and
> before upgrading should add an APT preferences file containing
> something like:
>
> (Or maybe as two sentences, "Before upgrading they should...")
Also we should not say "something like" since that suggests that some
system-specific adjustment is needed. I originally included those
words because I hadn't tested this configuration, but Paul said he
will.
>
> > + <programlisting>
> > +Package: linux-image-marvell
> > +Pin: release a=buster
> > +Pin-Priority: 900
> > + </programlisting>
> > + Obviously, the security support for this configuration will
> > + end with the End Of Life of buster.
>
> Obviously, the security support for this configuration will
> only last until buster's End Of Life.
We (generally) shouldn't say "obviously" in documentation - if we
bothered to document it, it must not be that obvious.
Ben.
--
Ben Hutchings
Kids! Bringing about Armageddon can be dangerous. Do not attempt it
in your own home. - Terry Pratchett and Neil Gaiman, `Good Omens'
Attachment:
signature.asc
Description: This is a digitally signed message part