httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rbo...@apache.org
Subject svn commit: r1334076 - /httpd/site/trunk/docs/docs-project/index.html
Date Fri, 04 May 2012 17:35:12 GMT
Author: rbowen
Date: Fri May  4 17:35:11 2012
New Revision: 1334076

URL: http://svn.apache.org/viewvc?rev=1334076&view=rev
Log:
New docs-project front page.

Modified:
    httpd/site/trunk/docs/docs-project/index.html

Modified: httpd/site/trunk/docs/docs-project/index.html
URL: http://svn.apache.org/viewvc/httpd/site/trunk/docs/docs-project/index.html?rev=1334076&r1=1334075&r2=1334076&view=diff
==============================================================================
--- httpd/site/trunk/docs/docs-project/index.html [utf-8] (original)
+++ httpd/site/trunk/docs/docs-project/index.html [utf-8] Fri May  4 17:35:11 2012
@@ -71,27 +71,17 @@ href="/info/">Miscellaneous</a></b></p>
  </tr>
  <tr><td>
   <blockquote>
-<p align="center">Online Documentation: 
-                     <a href="../docs/2.0/">Version 2.0</a> |
-                     <a href="../docs/2.2/">Version 2.2</a> |
-                     <a href="../docs/2.4/">Version 2.4</a> |
-                     <a href="../docs/trunk/">Version 2.5 (Development branch)</a>
|
-                     <a href="http://wiki.apache.org/httpd/">Wiki</a>
-                     </p>
-<p align="center">Downloadable documentation in Microsoft Help (CHM)
-format is available from our <a href="http://www.apache.org/dyn/mirrors/mirrors.cgi/httpd/docs/">distribution
mirrors</a>.</p>
-<p>The Documentation Project is an effort to maintain and improve the
-quality of the documentation included with the Apache HTTP Server.
-Participation is open to anyone willing to write documentation, edit for
-spelling, grammer or readability, or <a href="translations.html">translate</a>
-documentation into another language. Some knowledge of the Apache HTTP
-Server is helpful, but not required. No programming knowledge is required,
-so this is a great way for non-programmers to contribute to the success of 
-the Apache HTTP Server project, and to have their work read by millions 
-of Apache users.</p>
-<p>This is <strong>not</strong> a mailing list where users should ask
-questions on how to configure Apache.  The <a href="../userslist.html">Users List</a>
is available for that
-purpose.</p>
+<p>The documentation of the Apache HTTP Server is a collaborative
+effort, made possible by the participation of the entire HTTP Server
+community. We'd love to have your help too.</p>
+<ul>
+<li><a href="#report">I want to report a problem</a></li>
+<li><a href="#suggestion">I'd like to make a suggestion</a></li>
+<li><a href="#svn">I know how to use svn</a></li>
+<li><a href="#ml">I'd like to join the docs team mailing list</a></li>
+<li><a href="#translate">I want to help translate the documentation</a></li>
+<li><a href="#docs">Actually, I was just looking for the docs</a></li>
+</ul>
   </blockquote>
  </td></tr>
 </table>
@@ -99,37 +89,99 @@ purpose.</p>
  <tr>
  <td bgcolor="#525D76">
   <font color="#ffffff" face="arial,helvetica,sanserif">
-   <strong>How to get Involved</strong>
+   <a name="problem"><strong>Reporting a problem</strong></a>
   </font>
  </td>
  </tr>
  <tr><td>
   <blockquote>
-<p>There are several ways that you can contribute to the documentation
-effort. You can:
-<ul>
-<li><a href="mailto:docs-subscribe@httpd.apache.org">Subscribe to the
-docs@httpd.apache.org mailing list</a> and tell us something that could
-be improved.</li>
-<li>Join #httpd on irc.freenode.net and tell us there.</li>
-<li>Submit a ticket to the <a href="../bug_report.html">bug
-database</a>.</li>
-<li>Check out the documentation from svn (<a href="svn.html">instructions here</a>),
-and send us a patch.</li>
-</ul>
+<p>The best way to report a problem with the documentation is to <a href="https://issues.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">open
+a ticket</a>. Select 'Documentation' as the component. Have a look at
+the <a href="http://s.apache.org/httpd-doc-bugs">list of open
+documentation bugs</a> to see if it's already covered. We try to keep
+that list very short.</p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr>
+ <td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <a name="suggestion"><strong>Making a suggestion</strong></a>
+  </font>
+ </td>
+ </tr>
+ <tr><td>
+  <blockquote>
+<p>If you have a suggestion of something that we could do better, or
+even want to write a new or replacement document, there are a number of
+ways to go about it.</p>
+<p>The best way is probably to <a href="#ml">join the mailing list</a>
+and strike up a conversation. We always love to have new people on the
+project.</p>
+<p>Or, you can <a href="#problem">open a ticket</a>, as discussed
+above. We are very interested in your suggestions, and any way that you
+think we can improve the documentation. We look forward to hearing from
+you.</p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr>
+ <td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <a name="svn"><strong>SVN information</strong></a>
+  </font>
+ </td>
+ </tr>
+ <tr><td>
+  <blockquote>
+<p>Our documentation is kept in svn, along with the source code, and the
+actual changes are all made there. If you intend to be a long-term
+contributor to the documentation, the best thing to do is to get an svn
+checkout and submit patches. We've got a <a href="svn.html">document
+that gives you all of the necessary details</a>.</p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr>
+ <td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <a name="ml"><strong>The docs mailing list</strong></a>
+  </font>
+ </td>
+ </tr>
+ <tr><td>
+  <blockquote>
+<p>The discussion surrounding the documentation project happens on the
+<code>docs@httpd.apache.org</code> mailing list. To subscribe to this
+mailing list, send email to <a href="mailto:docs-subscribe@httpd.apache.org">docs-subscribe@httpd.apache.org</a>
+and follow the instructions in the response you receive.</p>
+<p>The archives of this mailing list may be found at <a href="http://apache.markmail.org/search/list:org.apache.httpd.docs">MarkMail</a>,
+if you want to have a preview of how we do things, and who the main
+characters are.</p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr>
+ <td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <a name="translate"><strong>Translations</strong></a>
+  </font>
+ </td>
+ </tr>
+ <tr><td>
+  <blockquote>
+<p>The documentation is available in several different languages. Some
+of these translations are out of date, and some important languages are
+missing. If you are fluent in a non-English language, and would like to
+provide a translation of all or part of the documentation, there's <a href="translations.html">another
document</a> about how to get started
+on that. Before you get started, please <a href="#ml">join the mailing
+list</a>, introduce yourself, and let us know what you're working on. In
+that way, other translators can coordinate with you in this effort.
 </p>
-<p>There are lots of ways to contribute to the documentation
-project, including fixing typos and spelling mistakes,
-translating the documentation into other languages, writing
-tutorials to help new users, or just expressing your
-opinion about suggested changes.</p>
-<p>For information on our use of XML in the documentation, see
-our <a href="docsformat.html">Documentation Format and
-Transformation</a> page.</p>
-<p>If you need inspiration for something to work on, look at our <a href="https://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/STATUS">STATUS</a>
-file for a list of things that we think need doing, and pick something
-that you think you can do. Patches against trunk are greatly
-appreciated, but contributions in any format are helpful.</p>
   </blockquote>
  </td></tr>
 </table>
@@ -137,14 +189,22 @@ appreciated, but contributions in any fo
  <tr>
  <td bgcolor="#525D76">
   <font color="#ffffff" face="arial,helvetica,sanserif">
-   <strong>Translation Projects</strong>
+   <a name="docs"><strong>Where are the docs?</strong></a>
   </font>
  </td>
  </tr>
  <tr><td>
   <blockquote>
-<p>Information about translating the documentation into other languages
-is available at the <a href="translations.html">translations page</a>.</p>
+<p>Documentation is available for several different versions of the server:</p>
+<p align="center">Online Documentation: 
+                     <a href="../docs/2.0/">Version 2.0</a> |
+                     <a href="../docs/2.2/">Version 2.2</a> |
+                     <a href="../docs/2.4/">Version 2.4</a> |
+                     <a href="../docs/trunk/">Version 2.5 (Development branch)</a>
|
+                     <a href="http://wiki.apache.org/httpd/">Wiki</a>
+                     </p>
+<p align="center">Downloadable documentation in Microsoft Help (CHM)
+format is available from our <a href="http://www.apache.org/dyn/mirrors/mirrors.cgi/httpd/docs/">distribution
mirrors</a>.</p>
   </blockquote>
  </td></tr>
 </table>
@@ -158,45 +218,9 @@ is available at the <a href="translation
  </tr>
  <tr><td>
   <blockquote>
-<p>Some of the participants are:</p>
-<ul>
-<li><a href="http://www.codefaktor.de/">Erik Abele</a></li>
-<li><a href="http://rkbloom.net/rbb/">Ryan Bloom</a></li>
-<li><a href="http://www.rcbowen.com/">Rich Bowen</a></li>
-<li>Vincent Bray</li>
-<li><a href="http://Golux.Com/coar/">Ken Coar</a></li>
-<li><a href="http://www.logilune.com/eric/">Eric Cholet</a></li>
-<li><a href="http://dotat.at/">Tony Finch</a></li>
-<li>Yoshiki Hayashi</li>
-<li><a href="http://www.kess-net.de/">Astrid Keßler</a></li>
-<li><a href="http://geeklog.lucid.net.au/">Jason Lingohr</a></li>
-<li>André L. Malo</li>
-<li><a href="http://www.reppep.com/~pepper/">Chris Pepper</a></li>
-<li>Dan Poirier</li>
-<li><a href="http://www.nerdchic.net/">Noirin Plunkett</a></li>
-<li>William A. Rowe, Jr.</li>
-<li><a href="http://slive.ca/">Joshua Slive</a></li>
-<li><a href="http://blog.pc-tony.com/">Tony Stevenson</a></li>
-<li><a href="http://www.toftum.org/">Mads Toftum</a></li>
-</ul>
-<p>The localized custom error messages in the 2.x version of the
-Apache HTTP Server were contributed by</p>
-<ul>
-<li>Ricardo Leite (Brazilian)</li>
-<li>Marcel Kolaja (Czech)</li>
-<li>Peter Van Biesen (Dutch)</li>
-<li>Lars Eilebrecht (English and German)</li>
-<li>Cecile de Crecy (French)</li>
-<li>Luigi Rosa (Italian)</li>
-<li>Noirin Plunkett (Irish)</li>
-<li>Jaeho Shin (Korean)</li>
-<li>Tomasz Kepczynski (Polish)</li>
-<li>Andrei Besleaga (Romanian)</li>
-<li>Nikola Smolenski (Serbian)</li>
-<li>Karla Quintero (Spanish)</li>
-<li>Thomas Sjögren (Swedish)</li>
-<li>Emre Sokullu (Turkish)</li>
-</ul>
+<p>The Apache HTTP Server documentation is the product of the work of
+many, many people. We've listed them <a href="contributors.html">over
+here</a>.</p>
   </blockquote>
  </td></tr>
 </table>



Mime
View raw message