Contributing to the Documentation - The Apache HTTP Server Project
Essentials ¶ Download! About License FAQ Security Reports Source Repositories ¶ General Information Trunk 2.4 Documentation ¶ Version 2.4 Trunk (dev) Wiki Get Involved ¶ Mailing Lists Bug Reports Developer Info User Support Subprojects ¶ Docs Test Flood Modules mod_fcgid Related Projects ¶ Apache Traffic Server Apache Traffic Control Tomcat APR mod_perl Miscellaneous ¶ Contributors Thanks! Sponsorship Privacy Contributing to the Apache HTTP Server Documentation ¶ We'd love your help improving the Apache HTTP Server documentation.
You don't need to be a programmer — if you can spot a confusing sentence, fix a typo, or explain something more clearly, you're already making a difference. Your work will be read by millions of httpd users worldwide. This page is about contributing to the docs , not about configuring httpd. For configuration help, see the Users mailing list . Before You Start ¶ No ICLA or ASF account is needed to submit documentation patches.
Anyone can contribute. The GitHub mirror (github.com/apache/httpd) is read-only — do NOT open pull requests there. They won't be reviewed. Patches go through SVN and the mailing list. Patches sent to the mailing list are typically reviewed within a few days. Ways to Contribute ¶ There's something for every skill level: Quick Wins (no SVN needed) ¶ Report a problem — Open a Bugzilla ticket describing what's wrong or confusing.
Suggest an improvement — Send a note to the docs mailing list with your idea. Join the conversation — Subscribe to docs@httpd.apache.org and weigh in on ongoing discussions. Fast Path for Small Fixes ¶ You don't need SVN to report a problem or suggest a fix. For typos or small corrections, just describe the fix in an email to docs@httpd.apache.org , or open a Bugzilla ticket with the corrected text. A committer will apply it for you.
For anything more than a sentence or two, the SVN patch workflow (described below) is preferred — it gives reviewers the full context of your change. Fix and Improve (SVN patch workflow) ¶ Fix typos, broken examples, or unclear explanations. Add missing configuration examples. Update outdated information. Improve the documentation for a module you know well. For these, you'll check out the docs from SVN, make your changes, and send us a patch.
See our SVN workflow guide for step-by-step instructions — it's straightforward even if you haven't used SVN before. Larger Contributions ¶ Write a new how-to or tutorial. Document a module that's missing coverage. Translate documentation into another language (see the translation guide ). For anything substantial, we recommend introducing yourself on the mailing list first. That way you can get feedback on your approach before investing a lot of time.
Getting Set Up ¶ Subscribe to the mailing list — Send email to docs-subscribe@httpd.apache.org . Check out the source — Follow our SVN instructions . Learn the format — Read about the documentation XML format and the style guide . Set up your tools — See Tools for Contributors for editor and workflow recommendations. Submitting Your Work ¶ The standard workflow is: Make your changes in your SVN checkout. Run svn diff > my-changes.patch to create a patch file.
Send the patch to docs@httpd.apache.org , or attach it to a Bugzilla ticket . Include a brief description of what you changed and why. Don't worry about getting everything perfect on the first try. We review all contributions and are happy to help you iterate. Communication Channels ¶ Mailing list: docs@httpd.apache.org ( subscribe | archives ) IRC: #httpd on irc.libera.chat Bug tracker: Bugzilla The XML Format ¶ The documentation is written in a custom XML format, transformed to HTML via XSLT.
If you're not familiar with XML, don't let that stop you — it's quite readable, and the community will help you with markup questions. See the documentation format page for details, and the style guide for markup conventions. Translation Projects ¶ If you'd like to translate the documentation into another language, see the translations page for how to get started. Copyright © 1997-2026 The Apache Software Foundation.
Apache HTTP Server, Apache, the Apache logo and the Apache HTTP Server logo are either registered trademarks or trademarks of The Apache Software Foundation in the United States and other countries.