Bug#1020248: debian-policy: Clarifying nomenclature for control file names
Guillem Jover <guillem@debian.org> writes:
> Ok, I've prepared the attached incremental patch, which only switches
> from paragraph(s) to stanza(s) all over the place.
Thanks, applied.
> I've updated all the specs for consistency. I've updated the footnote to
> swap the preference and to mention paragraph is now discouraged
> nomenclature. I've also updated all «id»s out of consistency, which
> might break links, so I can revert that if you'd prefer.
It looks like it was primarily in the copyright-format specification. I
think that's fine; we haven't historically tried hard to preserve anchors,
and if we ever did, we should probably use some scheme to assign stable
anchors rather than using the text of the heading.
> And I've preserved the (upper) casing for one of the titles
> (“Stand-alone License Stanza”, although that was not consistent with the
> other titles, such as “Files stanza”, I'm happy to lower case that one).
I personally have been convinced by a co-worker who did the research that
one should stop using title-casing in technical documents, since it's
mostly a US convention, US readers don't mind lowercase, and title-casing
can look weird to European readers. But that's a fix for another day.
> I've gone one by one, but please review carefully as I might have
> perhaps switched in excess!
Reviewed, and also checked for remaining uses of "paragraph." Everything
looked good.
--
Russ Allbery (rra@debian.org) <https://www.eyrie.org/~eagle/>
Reply to: