Since commit a6295b4, the httpd-site subsection of the Apache Development Notes page contains:
The website pages use the Markdown syntax and when a change is commited in this repository, the corresponding HTML files are automatically generated and copied on https://httpd.apache.org/.
While this may be basically true, it is quite misleading, because most pages on the website are part of docs/ and do not deploy automatically. The following fixes that and partially updates, since the structure was designed in SVN times. Apologies, GitHub makes the diff appears bigger than it really is.
diff --git a/content/dev/devnotes.md b/content/dev/devnotes.md
--- content/dev/devnotes.md
+++ content/dev/devnotes.md
@@ -73,49 +73,49 @@
developer checks the changes into the repository:
<samp>% svn commit httpd-trunk/modules/http/mod_mime.c</samp>
-# SVN Subtrees #
+# VCSs #
+## httpd-site ##
+The website **used** to be hosted at https://svn.apache.org/repos/asf/httpd/site/.
+
+It is **now** hosted on GitHub at https://github.com/apache/httpd-site/.
+
+The website pages which are versioned in that repository (which exclude most documentation pages) use the Markdown syntax and when a change is committed in this repository,
+the corresponding HTML files are automatically generated and copied on https://httpd.apache.org/.
+
+## SVN Subtrees ##
+
There are several different branches under the <samp>httpd</samp> subtree in
the Apache SVN repository that pertain to the different releases. The top
level can be perused with the [SVN
ViewCVS](https://svn.apache.org/viewcvs.cgi/) pages. The main subtrees
pertaining to the <samp>httpd</samp> server source are:
-## httpd-2.4 ##
+### httpd-2.4 ###
To create a directory tree containing the 2.4 sources, and call
it <samp>httpd-2.4</samp>, change your current directory to the *parent* of
the tree and then check the 2.4 sources out as follows:
% cd /usr/local/apache
% svn checkout https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x httpd-2.4
-## httpd-2.5 ##
+### httpd-2.5 ###
If you want to check out the bleeding edge of development, the httpd-2.5
development tree (slated for a release 2.6), and call
it <samp>httpd-trunk</samp>, checkout as follows:
% cd /usr/local/apache
% svn checkout https://svn.apache.org/repos/asf/httpd/httpd/trunk httpd-trunk
-## httpd-site ##
+### httpd-dist ###
-The website **used** to be hosted at https://svn.apache.org/repos/asf/httpd/site/.
-
-It is **now** hosted on GitHub at https://github.com/apache/httpd-site/.
-
-The website pages use the Markdown syntax and when a change is commited in this repository,
-the corresponding HTML files are automatically generated and copied on https://httpd.apache.org/.
-
-## httpd-dist ##
-
-Like the <samp>httpd-site</samp> subtree, this one is used to maintain the
-files that comprise a website - in this
-case, <samp>https://downloads.apache.org/httpd/</samp>. Also like the previous
-subtree, the directory on the server is a checked-out working copy of this
+Like the <samp>httpd-site</samp> repository, this one is used to maintain the
+files that comprise a website―in this
+case, <samp>https://downloads.apache.org/httpd/</samp>. The directory on the server is a checked-out working copy of this
subtree. However, since this is a distribution directory, we only have the
surrounding documentation and control files checked into this subtree --
the actual tarballs are simply copied to www.apache.org.By the way. the titles of level 2 sections are misformatted, showing more indented than contents.
🅭🄍
Since commit a6295b4, the httpd-site subsection of the Apache Development Notes page contains:
While this may be basically true, it is quite misleading, because most pages on the website are part of docs/ and do not deploy automatically. The following fixes that and partially updates, since the structure was designed in SVN times. Apologies, GitHub makes the diff appears bigger than it really is.
By the way. the titles of level 2 sections are misformatted, showing more indented than contents.
🅭🄍