X-Git-Url: https://git.donarmstrong.com/?p=debian%2Fdebian-policy.git;a=blobdiff_plain;f=README.org;h=a86f9e3c9c062a9def83faf7fa8e102295b2f35a;hp=322822921389b6bab501f7f700e7a7c2e7469d51;hb=HEAD;hpb=b3c26418bcbf2a63b69a4ee889791e7326fe764d diff --git a/README.org b/README.org index 3228229..a86f9e3 100644 --- a/README.org +++ b/README.org @@ -1,4 +1,4 @@ --*- mode: org; fill-column: 78 -*- +# -*- mode: org; fill-column: 78 -*- #+STARTUP: showall #+STARTUP: lognotedone lognotestate #+OPTIONS: H:4 toc:2 @@ -8,37 +8,14 @@ #+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:nil skip:t d:nil tags:not-in-toc #+LINK_HOME: http://wiki.debian.org/Teams/Policy #+LINK_UP: http://www.debian.org/ - -\usepackage{landscape} - -\setlength{\oddsidemargin}{0in} % default=0in -\setlength{\textwidth}{9in} % default=9in - -\setlength{\columnsep}{0.5in} % default=10pt -\setlength{\columnseprule}{1pt} % default=0pt (no line) - -\setlength{\textheight}{5.85in} % default=5.15in -\setlength{\topmargin}{-0.15in} % default=0.20in -\setlength{\headsep}{0.25in} % default=0.35in - -\setlength{\parskip}{1.2ex} -\setlength{\parindent}{0mm} -\pagestyle{empty} - -\setlength{\headheight}{0pt} -\setlength{\headsep}{0pt} -\setlength{\footskip}{5pt} -\setlength{\textheight}{9.0in} -\setlength{\textwidth}{6.5in} - - +#+LATEX_HEADER: \input{README-header.tex} * Infrastructure + Website:: http://www.debian.org/doc/devel-manuals#policy + Mailing list:: debian-policy@lists.debian.org lists + Source Code:: - * git clone git://git.debian.org/git/dbnpolicy/policy.git - * Browser: http://git.debian.org/?p=dbnpolicy/policy.git + * git clone git://anonscm.debian.org/dbnpolicy/policy.git + * Browser: http://anonscm.debian.org/gitweb/?p=dbnpolicy/policy.git + Unix group:: dbnpolicy + Alioth Project:: http://alioth.debian.org/projects/dbnpolicy (exists to manage the repository but not otherwise used) @@ -51,14 +28,14 @@ Debian Policy uses a formal procedure and a set of user tags to manage the lifecycle of change proposals. For definitions of those tags and proposal states and information about what the next step is for each -phase, see PolicyChangesProcess. +phase, see [[./Process.org][Policy changes process]]. Once the wording for a change has been finalized, please send a patch against the current Git master branch to the bug report, if you're not familiar with Git, the following commands are the basic process: #+BEGIN_SRC Sh -git clone git://git.debian.org/git/dbnpolicy/policy.git +git clone git://anonscm.debian.org/dbnpolicy/policy.git git checkout -b # edit files, but don't make changes to upgrading-checklist or debian/changelog @@ -70,14 +47,18 @@ git commit git checkout master git pull -# If there are changes in master that make the branch not apply cleanly: - : git checkout -b temp master; git merge -# If error, reset temp, merge master into local; else skip these three lines - : git reset --hard HEAD; - : git checkout ; +git checkout master +git merge --no-commit +git reset --hard HEAD; +git checkout ; + +# If there are changes in master that make the branch not apply cleanly, there +# should have been en error during the merge step above. If there was an +# error, merge the master branch into the local branch, fix the conflicts, and +# commit the new version of the local branch. : git merge master -# get rid of the temp branch: - : git branch -D temp +# Edit files to remove conflict + : git commit -s # Checkout the local branch, to create the patch to send to the policy git checkout @@ -101,22 +82,35 @@ delegation). All of the Policy team members do basically the same work: shepherd proposals, propose wording, and merge changes when consensus has been reached. The current delegates are: -+ Russ Allbery -+ Bill Allombert -+ Andrew McMillan -+ Manoj Srivastava -+ Colin Watson (cjwatson) ++ Andreas Barth (aba) ++ Bill Allombert (ballombe) ++ Jonathan Nieder (jrnieder) ++ Russ Allbery (rra) + +* Task description + +The Debian Policy team is responsible for maintaining and coordinating +updates to the Debian Policy Manual and all the other policy documents +released as part of the "debian-policy" package. -The special tasks of Policy delegates are: +The Debian Policy Editors: -+ Commit access to the Git repository and uploads of the debian-policy - package itself, which makes them responsible for debian-policy as a - package in Debian and for making final decisions about when a new - version is released and what bits go into it. -+ Rejecting proposals. Anyone can argue against a proposal, but only - Policy delegates can formally reject it. -+ Counting seconds and weighing objections to proposals to determine - whether the proposal has sufficient support to be included. ++ Guide the work on the Debian Policy Manual and related documents as a + collaborative process where developers review and second or object to + proposals, usually on the debian-policy mailing list. + ++ Count seconds and weight objections to proposals, to determine whether + they have reached sufficient consensus to be included, and accept + consensual proposals. + ++ Reject or refer to the Technical Committee proposals that fail to + reach consensus. + ++ Commit changes to the version control system repository used to + maintain the Debian Policy Manual and related documents. + ++ Maintain the "debian-policy" package. As package maintainers, they + have the last word on package content, releases, bug reports, etc. Everything else can be done by anyone, or any DD (depending on the outcome of the discussion about seconding). We explicitly want any @@ -124,23 +118,15 @@ Debian DD to review and second or object to proposals. The more participation, the better. Many other people are active on the Policy mailing list without being project delegates. -* Task description - -The Debian Policy team is responsible for maintaining and coordinating -updates to the technical Policy manuals for the project. The primary -output of the team is the Debian Policy Manual and the assorted -subpolicies, released as the debian-policy Debian package and also -published at [[http://www.debian.org/doc/]]. - In addition to the main technical manual, the team currently also maintains: ++ [[http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/][Machine-readable debian/copyright format]] + [[http://www.debian.org/doc/packaging-manuals/menu-policy/][Debian Menu sub-policy]] + [[http://www.debian.org/doc/packaging-manuals/perl-policy/][Debian Perl Policy]] -+ [[http://www.debian.org/doc/packaging-manuals/mime-policy/][Debian MIME support sub-policy]] + [[http://www.debian.org/doc/packaging-manuals/debconf_specification.html][Debconf Specification]] + [[http://www.debian.org/doc/packaging-manuals/virtual-package-names-list.txt][Authoritative list of virtual package names ]] -These documents are maintained using the [[http://wiki.debian.org/PolicyChangesProcess][Policy changes process]], and +These documents are maintained using the [[./Process.org][Policy changes process]], and the current state of all change proposals is tracked using the [[http://bugs.debian.org/src:debian-policy][debian-policy BTS]]. @@ -154,7 +140,7 @@ will involve guiding the discussion, seeking additional input (particularly from experts in the area being discussed), possibly raising the issue on other mailing lists, proposing or getting other people to propose specific wording changes, and writing diffs against -the current Policy document. All of the steps of [[http://wiki.debian.org/PolicyChangesProcess][Policy changes process]] +the current Policy document. All of the steps of [[./Process.org][Policy changes process]] can be done by people other than Policy team members except the final acceptance steps and almost every change can be worked on independently, so there's a lot of opportunity for people to help. @@ -235,12 +221,20 @@ git push origin bug12345-rra # update your local master branch git checkout master git pull -# If there are changes in master that make the branch not apply cleanly: -: git checkout -b temp master; git merge bug12345-rra -# If error; -: git reset --hard HEAD; -: git checkout bug12345-rra; git branch -D temp -: git merge master + +git checkout master +git merge --no-commit bug12345-rra +git reset --hard HEAD; + +# If there are changes in master that make the branch not apply cleanly, there +# should have been en error during the merge step above. If there was an +# error, merge the master branch into the local branch, fix the conflicts, and +# commit the new version of the local branch. + : git checkout bug12345-rra + : git merge master +# Edit files to remove conflict + : git commit -s + git checkout master git merge bug12345-rra # edit debian/changelog and upgrading-checklist.html @@ -319,11 +313,10 @@ useful, when trying to find a place to start, to pick a manageable set of bugs and set as a target resolving them completely before the next Policy release. Resolving a bug means one of the following: -+ Proposing new language to address the bug that's seconded and - approved by the readers of the Policy list following the - PolicyChangesProcess (or that's accepted by one of the Policy - delegates if the change isn't normative; i.e., doesn't change the - technical meaning of the document). ++ Proposing new language to address the bug that's seconded and approved by + the readers of the Policy list following the [[./Progress.org][Policy changes process]] (or + that's accepted by one of the Policy delegates if the change isn't + normative; i.e., doesn't change the technical meaning of the document). + Determining that the bug is not relevant to Policy and closing it. + Determining that either there is no consensus that the bug indicates a problem, that the solutions that we can currently come up with are