| 1 |
<html><head><title>Open Issues</title></head>
|
| 2 |
<!-- begin header -->
|
| 3 |
<body bgcolor="#ffffff">
|
| 4 |
<table width="100%" BORDER=3 CELLPADDING=5>
|
| 5 |
<tr>
|
| 6 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="index.html">H<font size="-1">OME</font></a>
|
| 7 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="news.html">N<font size="-1">EWS</font></a>
|
| 8 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="topics.html">T<font size="-1">OPICS</font></a>
|
| 9 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="issues.html">I<font size="-1">SSUES</font></a>
|
| 10 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="ideas.html">I<font size="-1">DEAS</font></a>
|
| 11 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="todo.html">T<font size="-1">ODO</font></a>
|
| 12 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="docpolicy.html">P<font size="-1">OLICY</font></a>
|
| 13 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="links.html">L<font size="-1">INKS</font></a>
|
| 14 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="manuals.html">M<font size="-1">ANUALS</font></a>
|
| 15 |
</table><p>
|
| 16 |
|
| 17 |
<!-- end header -->
|
| 18 |
|
| 19 |
<h1>Open issues</h1>
|
| 20 |
We'll have to discuss these issues sometime in the future:
|
| 21 |
<ol>
|
| 22 |
<li><strong>Make tools available.</strong>
|
| 23 |
<p>
|
| 24 |
Chris is currently working on a few additions to debiandoc-sgml.
|
| 25 |
<p>
|
| 26 |
<li><strong>Decide which documents we want to have.</strong>
|
| 27 |
<p>
|
| 28 |
<li><strong>Choose objectives and TOC's for each document.</strong>
|
| 29 |
<p>
|
| 30 |
Have each of the documents point to a page which gives the
|
| 31 |
objectives and TOC for that document as they is currently understood.
|
| 32 |
<p>
|
| 33 |
<li><strong>Decide how many packages we need.</strong>
|
| 34 |
<p>
|
| 35 |
Having one package per document has the following advantages:
|
| 36 |
<ul>
|
| 37 |
<li>Packages will be small. If a single document is updated, one does
|
| 38 |
not have to download all documents.
|
| 39 |
<li>Things are clearer if the package maintainer is the
|
| 40 |
document maintainer (i.e. author).
|
| 41 |
<li>One can easily report bugs against documents.
|
| 42 |
</ul>
|
| 43 |
but also the following disadvantages:
|
| 44 |
<ul>
|
| 45 |
<li>We already have enough packages and some users already complain
|
| 46 |
that there are too many.
|
| 47 |
</ul>
|
| 48 |
<p>
|
| 49 |
Here is a <a href="packages.html">proposal</a>.
|
| 50 |
<p>
|
| 51 |
<li><strong>Decide what we want to distribute in our packages.</strong>
|
| 52 |
<p>
|
| 53 |
<li><strong>Define priorities and sign up authors.</strong>
|
| 54 |
<p>
|
| 55 |
<li><strong>Decide a policy for translations of our manuals into non-english
|
| 56 |
languages.</strong>
|
| 57 |
</ol>
|
| 58 |
|
| 59 |
<!-- begin footer -->
|
| 60 |
<p>
|
| 61 |
<hr><p>
|
| 62 |
Please send all comments, criticisms and suggestions about these web pages
|
| 63 |
to <a href="mailto:olly@lfix.co.uk">Oliver Elphick</a> or to the
|
| 64 |
mailing list of the
|
| 65 |
<a href="mailto:debian-doc@lists.debian.org">Debian Documentation Team</a>.
|
| 66 |
<p>
|
| 67 |
<I>Last changed on 7 July 1998 by <A HREF="mailto:olly@lfix.co.uk">Oliver Elphick</A></I>
|
| 68 |
</body></html>
|
| 69 |
<!-- end footer -->
|