You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@apache.org on 2012/05/04 19:32:12 UTC

svn commit: r1334073 - in /httpd/site/trunk/xdocs/docs-project: contributors.xml index.xml

Author: rbowen
Date: Fri May  4 17:32:11 2012
New Revision: 1334073

URL: http://svn.apache.org/viewvc?rev=1334073&view=rev
Log:
A more complete contributors list, and a rewritten docs project front
page, with more focus on how to get involved.

Added:
    httpd/site/trunk/xdocs/docs-project/contributors.xml
Modified:
    httpd/site/trunk/xdocs/docs-project/index.xml

Added: httpd/site/trunk/xdocs/docs-project/contributors.xml
URL: http://svn.apache.org/viewvc/httpd/site/trunk/xdocs/docs-project/contributors.xml?rev=1334073&view=auto
==============================================================================
--- httpd/site/trunk/xdocs/docs-project/contributors.xml (added)
+++ httpd/site/trunk/xdocs/docs-project/contributors.xml [utf-8] Fri May  4 17:32:11 2012
@@ -0,0 +1,122 @@
+<?xml version="1.0"?>
+<document>
+  <properties>
+    <title>Documentation - Contributors</title>
+  </properties>
+<body>
+<section>
+<title>Documentation - Contributors</title>
+
+<p>The Apache HTTP Server documentation is the product of the work of  many, many people. The following people have at one time or another contributed to the Apache HTTP Server documentation. Thanks to all of them!</p>
+
+<ul>
+<li>aaron : Aaron Bannert</li>
+<li>akosut : Alexei Kosut</li>
+<li>ben : Ben Laurie</li>
+<li>bjh : Brian Havard</li>
+<li>bnicholes : Bradley Nicholes</li>
+<li>brian : </li>
+<li>brianp : Brian Pane</li>
+<li>cholet : Eric Cholet</li>
+<li>chrisd : Chris Darroch</li>
+<li>chuck : Chuck Murcko</li>
+<li>clar : Jean-Jacques Clar</li>
+<li>coar : Ken A L Coar</li>
+<li>colm : Colm MacCarthaigh</li>
+<li>covener : Eric Covener</li>
+<li>dgaudet : </li>
+<li>dirkx : Dirk-Willem van Gulik</li>
+<li>dpejesh : David Shane Holden</li>
+<li>dreid : David Reid</li>
+<li>druggeri : Daniel Ruggeri</li>
+<li>erikabele : Erik Abele</li>
+<li>fanf : Tony Finch</li>
+<li>fielding : Roy T. Fielding</li>
+<li>fuankg : Guenter Knauf</li>
+<li>geoff : Geoffrey Young</li>
+<li>gregames : Greg Ames</li>
+<li>gryzor : Vincent Deffontaines</li>
+<li>humbedooh : Daniel Victor Gruno</li>
+<li>ianh : Ian Holsman</li>
+<li>igalic : Igor Galić</li>
+<li>jerenkrantz : Justin Erenkrantz</li>
+<li>jfclere : Jean-Frederic Clere</li>
+<li>jim : Jim Jagielski</li>
+<li>jorton : Joe Orton</li>
+<li>jsl : Jason S. Lingohr</li>
+<li>jwoolley : Cliff Woolley</li>
+<li>kawai : Hiroaki Kawai</li>
+<li>kbrand : Kaspar Brand</li>
+<li>keith : Keith Wannamaker</li>
+<li>kess : Astrid Kessler</li>
+<li>kevlo : </li>
+<li>lars : Lars Eilebrecht</li>
+<li>lgentis : Lucien Gentis</li>
+<li>lookit : </li>
+<li>maczniak : Jeon Jeongho</li>
+<li>madhum : Madhusudan Mathihalli</li>
+<li>mads : Mads Toftum</li>
+<li>manoj : Manoj Kasichainula</li>
+<li>marc : Marc Slemko</li>
+<li>martin : Martin Kraemer</li>
+<li>minfrin : Graham Leggett</li>
+<li>mjc : Mark J. Cox</li>
+<li>mturk : Mladen Turk</li>
+<li>nd : Andre Malo</li>
+<li>nilgun : Nilgun Belma Buguner</li>
+<li>niq : Nicholas Robert Kew</li>
+<li>noirin : Noirin Plunkett</li>
+<li>noodl : Vincent Bray</li>
+<li>patrikj : </li>
+<li>paul : </li>
+<li>pcs : </li>
+<li>pctony : Tony Stevenson</li>
+<li>pepper : Chris Pepper</li>
+<li>poirier : Daniel Earl Poirier</li>
+<li>pquerna : Paul Querna</li>
+<li>randy : Randy Terbush</li>
+<li>rasmus : </li>
+<li>rbb : Ryan Bloom</li>
+<li>rbowen : Richard Bowen</li>
+<li>rederpj : Paul J. Reder</li>
+<li>rjung : Rainer Jung</li>
+<li>ronald : Ronald Tschalar</li>
+<li>rpluem : Ruediger Pluem</li>
+<li>rse : Ralf S. Engelschall</li>
+<li>sameer : Sameer Parekh</li>
+<li>sctemme : Sander Temme</li>
+<li>sf : Stefan Fritsch</li>
+<li>slive : Joshua Slive</li>
+<li>stas : Stas Bekman</li>
+<li>stoddard : Bill Stoddard</li>
+<li>striker : Sander Striker</li>
+<li>takashi : Takashi Sato</li>
+<li>tdonovan : Thomas J. Donovan</li>
+<li>thommay : Thom May</li>
+<li>trawick : Jeff Trawick</li>
+<li>wrowe : William A. Rowe Jr.</li>
+<li>wsanchez : Wilfredo Sanchez</li>
+<li>yoshiki : Yoshiki Hayashi</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&#246;gren (Swedish)</li>
+<li>Emre Sokullu (Turkish)</li>
+</ul>
+
+</section>

Modified: httpd/site/trunk/xdocs/docs-project/index.xml
URL: http://svn.apache.org/viewvc/httpd/site/trunk/xdocs/docs-project/index.xml?rev=1334073&r1=1334072&r2=1334073&view=diff
==============================================================================
--- httpd/site/trunk/xdocs/docs-project/index.xml [utf-8] (original)
+++ httpd/site/trunk/xdocs/docs-project/index.xml [utf-8] Fri May  4 17:32:11 2012
@@ -7,6 +7,87 @@
 <section>
 <title>Documentation Project</title>
 
+<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>
+
+</section>
+
+<section id="problem">
+<title>Reporting a problem</title>
+<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>
+</section>
+
+<section id="suggestion">
+<title>Making a suggestion</title>
+<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>
+</section>
+
+<section id="svn">
+<title>SVN information</title>
+<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>
+</section>
+
+<section id="ml">
+<title>The docs mailing list</title>
+<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>
+</section>
+
+<section id="translate">
+<title>Translations</title>
+<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>
+</section>
+
+<section id="docs">
+<title>Where are the docs?</title>
+<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> |
@@ -18,111 +99,16 @@
 <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>
-
 </section>
-<section>
-<title>How to get Involved</title>
-
-<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>
-
-<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>
 
 </section>
 
 <section>
-<title>Translation Projects</title>
-
-<p>Information about translating the documentation into other languages
-is available at the <a
-href="translations.html">translations page</a>.</p>
-
-</section>
-<section>
 <title>Participants</title>
 
-<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&#223;ler</a></li>
-<li><a href="http://geeklog.lucid.net.au/">Jason Lingohr</a></li>
-<li>Andr&#233; 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&#246;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>
 
 </section>
 </body>