Bug#616465: debian-policy: description file in each system directory
sergey <sergey_ifeo@rambler.ru> writes:
> 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.
Hi sergey,
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.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: