Skip to content

Get Involved―How: Suggests docs@httpd.apache.org, without mentioning its posting restrictions #27

@Chealer

Description

@Chealer

The How section of the Contribute page contains:

Documentation patches may be sent to the docs@httpd mailing list.

This is likely to cause a poor developer experience, since that list has posting restrictions.
I suggest solving issue #24 and then:

diff --git a/content/contribute/index.md b/content/contribute/index.md
--- content/contribute/index.md
+++ content/contribute/index.md
@@ -1,21 +1,22 @@
 Title: Apache HTTP Server: Contribute
 license: https://www.apache.org/licenses/LICENSE-2.0
 
-Just the facts ... where and how to contribute.
+Just the facts… where and how to contribute.
 
 # Where
 
-The source code is in svn at:
+The software’s source code is in svn at:
 
  * Trunk: <samp>https://svn.apache.org/repos/asf/httpd/httpd/trunk</samp>
  * 2.4 (stable): <samp>https://svn.apache.org/repos/asf/httpd/httpd/2.4.x</samp>
 
-The source is also [mirrored on Github](https://github.com/apache/httpd)
+The source is also [mirrored on GitHub](https://github.com/apache/httpd).
 
 (Further details in [Developer Info](../dev/))
 
-The documentation source is in each version's source tree, under <samp>docs/manual/</samp>
+## Documentation and website
+The documentation source is in each version's source tree, under <samp>docs/manual/</samp>.
 
 Website source is at: <samp>https://github.com/apache/httpd-site</samp>
 
 # How
@@ -23,18 +24,16 @@
 Patches may be submitted by mailing output of <samp>svn diff</samp> to
 the [dev@httpd](https://lists.apache.org/list.html?dev@httpd.apache.org)
 mailing list, or via a pull request at the above Github repo.
 
-Documentation patches may be sent to the
-[docs@httpd](https://lists.apache.org/list.html?docs@httpd.apache.org)
-mailing list.
+Documentation patches may be sent to 
+[the `docs` mailing list](https://httpd.apache.org/lists.html#http-docs).
 
 (Further details about how to generate an svn diff are in the
-[devnotes](../dev/devnotes.html)
+[devnotes](../dev/devnotes.html))
 
 # What
 
 Places to find good things to work on include:
 
 * The [STATUS file](https://svn.apache.org/repos/asf/httpd/httpd/trunk/STATUS)
-* The [bug tracker](../bug_report.html)
-
+* [Issue trackers](../bug_report.html)

🅭🄍

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions