src/documentation/content/xdocs/dtd/todo-v11.mod

   1 <!--
   2   Copyright 1999-2004 The Apache Software Foundation
   3
   4   Licensed under the Apache License, Version 2.0 (the "License");
   5   you may not use this file except in compliance with the License.
   6   You may obtain a copy of the License at
   7
   8       http://www.apache.org/licenses/LICENSE-2.0
   9
  10   Unless required by applicable law or agreed to in writing, software
  11   distributed under the License is distributed on an "AS IS" BASIS,
  12   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13   See the License for the specific language governing permissions and
  14   limitations under the License.
  15 -->
  16 <!-- ===================================================================
  17
  18      Apache Todos module (Version 1.0)
  19
  20 PURPOSE:
  21   This DTD was developed to create a simple yet powerful document
  22   type for software development todo lists for use with the Apache projects.
  23   It is an XML-compliant DTD and it's maintained by the Apache XML
  24   project.
  25
  26 TYPICAL INVOCATION:
  27
  28   <!ENTITY % todo PUBLIC
  29       "-//APACHE//ENTITIES Todo Vxy//EN"
  30       "todo-vxy.mod">
  31   %todo;
  32
  33   where
  34
  35     x := major version
  36     y := minor version
  37
  38 NOTES:
  39   It is important, expecially in open developped software projects, to keep
  40   track of software changes that need to be done, planned features, development
  41   assignment, etc. in order to allow better work parallelization and create
  42   an entry point for people that want to help. This DTD wants to provide
  43   a solid foundation to provide such information and to allow it to be
  44   published as well as distributed in a common format.
  45
  46 FIXME:
  47   - do we need anymore working contexts? (SM)
  48
  49 CHANGE HISTORY:
  50 [Version 1.0]
  51   19991129 Initial version. (SM)
  52   19991225 Added actions element for better structure (SM)
  53 [Version 1.1]
  54   20011212 Used public identifiers for external entities (SM)
  55
  56 ==================================================================== -->
  57 <!-- =============================================================== -->
  58 <!-- Common entities -->
  59 <!-- =============================================================== -->
  60 <!ENTITY % priorities "showstopper|high|medium|low|wish|dream">
  61 <!-- =============================================================== -->
  62 <!-- Document Type Definition -->
  63 <!-- =============================================================== -->
  64 <!ELEMENT todo (title?, devs?, actions+)>
  65 <!ATTLIST todo
  66   %common.att;
  67 >
  68
  69 <!ELEMENT actions (action+)>
  70 <!ATTLIST actions
  71   %common.att;
  72   priority (%priorities;) #IMPLIED
  73 >
  74 <!-- =============================================================== -->
  75 <!-- End of DTD -->
  76 <!-- =============================================================== -->