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

Warning for incomplete/bad manual

On Sun, Feb 10, 2002 at 09:03:08PM -0800, Paul E Condon wrote:
> I suggest that there should be a standard format warning within the 
> document itself, so that it stays with the document even if it is printed.
> For example, just below the title:

If you want to do it, it should be in <abstract> section.

 |                       Deprecated!                          |
 |  This document is not maintained by the author and may     |
 |  contain incorrect information.                            |
 |  Use it for research into Debian's past, only.             |
 |                 Date: DD/MMM/YYYY  Debian docs maintainer  |

Should be suffice.  Note softer wording because it may be correct.  Also
I think there should be a date recorded for this action since document
date can be updated with the last cron build date superfluously.

I think this should be done for the document without update over a year
and its author can not be reached or he adimit its outdated.

First maintainer needs to make decision.  Then this needs to be informed
to the original author as a courtesy.  Give at least 2 weeks for
response from them.

> If the addition of something such as this mucks up the pagination in
> the document, so be it. 
... No it does not. (debiandoc is smart)
> With such a warning inserted into the document, it should not be
> necessary to hide the document in a special place. 

That's why I am calling to put them into "archive" = "closet" :)

+  Osamu Aoki <debian@aokiconsulting.com> @ Cupertino, CA USA         +

Reply to: