[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Monthly FAQ for the Debian-user mailing list



On Saturday, October 01, 2022 06:10:48 AM The Wanderer wrote:
> On 2022-10-01 at 05:46, Andrew M.A. Cater wrote:
> > Debian-user is a mailing list provided for support for Debian users,
> > and to facilitate discussion on relevant topics.

> I therefore reiterate my suggestion, from what I think was one of the
> first times (a previous version of?) this FAQ was (re)posted, that some
> versioning information be attached to - and posted along with each copy
> of - this FAQ.

+1

And I would expand the suggestion to add "revision marks" (ideally in the left 
margin) of the changed sections.

After all, many of us are used to using (word)diff or similar.

(And, this should be done for all legal type documents (changes in terms, 
etcs.)

(And, to go one step further, those emails (not from Debian) which say some 
list of terms / items has been changed, but without describing the change are 
also annoying -- you don't know whether the change might be relevant to you or 
not and you have to decide whether to follow the link and then (probably) try 
to skim a large part of the document to see what has changed.)

-- 
rhk

If you reply: snip, snip, and snip again; leave attributions; avoid HTML; 
avoid top posting; and keep it "on list".  (Oxford comma included at no 
charge.)  If you change topics, change the Subject: line. 

Writing is often meant for others to read and understand (legal agreements 
excepted?) -- make it easier for your reader by various means, including 
liberal use of whitespace and minimal use of (obscure?) jargon, abbreviations, 
acronyms, and references.

If someone else has already responded to a question, decide whether any 
response you add will be helpful or not ...

A picture is worth a thousand words -- divide by 10 for each minute of video 
(or audio) or create a transcript and edit it to 10% of the original.


Reply to: