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

Re: scope creep in DDP Policy



Correction:

On Wed, Jan 29, 2003 at 01:00:41AM -0800, Osamu Aoki wrote:
> Javi, the only way to get these existing documents to come under DDP is
> not by forcing through policy but by coercion.  I think we successfully
> advocated for "Installation manual" but we still need to convince
> "Developers Reference" author.  I mean Adam needs to be coerced ;-)  

I was confused :-(  developer-reference is already in DDP.

After some research, I found that the situation over "which documents
shall be covered by DDP?" is not too bad.  Anyway corresponding sections
in manuals.sgml needs update as follows to match new scope for Policy
Proposal:

<list>
<item>Users' manuals
<list>
<item>Debian GNU/Linux FAQ
<item>Debian Installation Manual (*)
<item>Debian Release Notes (*)
<item>Debian Reference
<item>APT HOWTO
<item>dselect Documentation for Beginners (*)
<item>User's Guide
<item>Euro support in Debian GNU/Linux
<item>Debian GNU/Linux and Java FAQ
<item>Securing Debian Manual
</list>
<item>Developers' manuals
<list>
<item>Debian Policy Manual (**)
<item>Debian Developer's Reference
<item>dpkg Internals Manual (***)
<item>Debian Menu System (**)
<item>Introduction to i18n
</list>
<item>Miscellaneous manuals
<list>
<item>Debian Project History
<item>Debiandoc-SGML Markup Manual (***)
<item>Debian SGML/XML HOWTO
</list>
</list>
<p>
Here, some documents are not controlled by DDP at this moment:
<list>
<item>(*) will be moved to DDP.
<item>(**) are provided by the Debian Policy List
  <email>debian-policy@lists.debian.org</email>.
  Policy Proposal will not enforce rules to these at this moment but will
  try to invite them into new DDP infrastructure.
<item>(***) are provided by the corresponding package.
  Policy Proposal  will not enforce rules to these at this moment but will
  try to invite them into new DDP infrastructure.
</list>

Please note I am removing 
    "Debian Guide"
    "The Debian Linux User's Guide"
    "The Linux Cookbook"
    "Linux Magazines" 
since these are online versions of printed books, provided by their
authors and the packagers.  DDP will not edit them. Also "Linux
Magazines" is not Debian specific.  I consider them to be "contrib" type
of documents which we thank but are not ready to claim control on them
as a part of DDP.  If any one of the author would like to be included, I
am happy.  

Repeat:
All translations of DDP documents must be covered by DDP new Policy
Proposal.

Reminder:
If current Policy Proposal is successful, we will consider to attack
following issues:
 1. Maintenance of Policy Documents 
   (including some core Debian Documents such as DSFG)
 2. Translation frame work
 3. Packaging coordination
 4. Style of package for package specific documentation. 
   (-doc, -docs, doc-..., include SGML in binary or not.)
 5. ... Plug any concern here :-)

Osamu
-- 
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
        Osamu Aoki <osamu@debian.org>   Cupertino CA USA, GPG-key: A8061F32
 .''`.  Debian Reference: post-installation user's guide for non-developers
 : :' : http://qref.sf.net and http://people.debian.org/~osamu
 `. `'  "Our Priorities are Our Users and Free Software" --- Social Contract

Attachment: pgpv1lRBwVIv9.pgp
Description: PGP signature


Reply to: