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

Bug#616465: marked as done (require description file in each system directory)

Your message dated Thu, 03 Jan 2013 13:30:02 -0800
with message-id <87ip7et0o5.fsf@windlord.stanford.edu>
and subject line Re: Bug#616465: debian-policy: description file in each system directory
has caused the Debian Bug report #616465,
regarding require description file in each system directory
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
616465: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=616465
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: debian-policy
Severity: wishlist


Excuse me for my bad English :-)

What do you think about placing README in each system directory?

IMHO it make system exploration more interesting for new users and can be helpful for 
expirienced users too.

Now Debian 6 already contain READMEs in some system directories:
/etc/init.d/README,
/etc/grub.d/README,
/usr/share/menu/README,
/usr/share/WindowMaker/README
etc.

Policy should define types of directories that must contain README.
It can also define requirement to file format and content.
In this case, file name can be other than README.

It will be good if directory description file name and content will
be published by http://www.freedesktop.org after it becames standart
de-facto :-)

------------------
Regards, Sergey


-- System Information:
Debian Release: 6.0
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 2.6.30-2-686 (SMP w/1 CPU core)
Locale: LANG=ru_RU.UTF-8, LC_CTYPE=ru_RU.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

--- End Message ---
--- Begin Message --- 
Russ Allbery <rra@debian.org> writes:

> For the reasons already discussed by others, I don't think that Policy
> is the appropriate place to do this.  There's definitely some merit to
> the idea, but I don't think it rises to the level of making it a Policy
> recommendation, particularly since it's not widespread current practice
> and normally packages put their documentation elsewhere (such as in man
> pages).

> I'm accordingly tagging this bug wontfix, but will leave it open for a
> little while in case anyone has any objections and wants to argue for
> this in Policy.

And per previous discussion am now closing this bug.

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>

--- End Message ---
Reply to: