Re: proofreading the installation-guide
On Sun, Jul 26, 2015 at 02:37:45PM +0100, Justin B Rye wrote:
> Hendrik Boom wrote:
> > Justin B Rye wrote:
> >> * &entity questions - when am I meant to say "Debian" and when is it
> >> "&debian;"? This like many of these entities seems to have no
> >> obvious function other than to make the source harder to
> >> interpret...
> >> * The &d-i; entity expands to "debian-installer" in bold verbatim
> >> lowercase. If that is in effect the brandname of the software
> >> project then presumably we shouldn't be talking about "the
> >> &d-i;" - that ought to be "the Debian installer".
> > Presumably both of these parametrisations are for the convenience of
> > Debian derivatives and forks. By making these macros, it's easier for
> > the, and it'll be easier for us to merge downstream patches.
> An interesting idea, but one that seems unlikely to work, especially
> given the way it's used in the text. For instance, there's a page
> "welcome/what-is-debian-linux.xml", which is full of sentences like
> "&debian; was the first Linux distribution to include a package
> management system".
It makes me wonder whether this was originally the intention, but has
become lost as generations of editors failed to follow up on it.