You are viewing a plain text version of this content. The canonical link for it is here.
Posted to bugs@httpd.apache.org by "Chealer (via GitHub)" <gi...@apache.org> on 2026/05/07 14:56:00 UTC
[I] Apache Development Notes claim httpd-site deployment is automatic [httpd-site]
Chealer opened a new issue, #31:
URL: https://github.com/apache/httpd-site/issues/31
Since commit a6295b4, [the _httpd-site_ subsection of the _Apache Development Notes_ page](https://httpd.apache.org/dev/devnotes.html#httpd-site) 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
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.
[🅭🄍](https://www.philippecloutier.com/Common+infrastructure+licensing#its)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
Re: [I] Apache Development Notes claim website deployment is automatic [httpd-site]
Posted by "notroj (via GitHub)" <gi...@apache.org>.
notroj commented on issue #31:
URL: https://github.com/apache/httpd-site/issues/31#issuecomment-4398281635
Stop filing diffs as issues, please, @Chealer - it just makes life harder for the maintainers to review and merge these.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org
Re: [I] Apache Development Notes claim website deployment is automatic [httpd-site]
Posted by "notroj (via GitHub)" <gi...@apache.org>.
notroj closed issue #31: Apache Development Notes claim website deployment is automatic
URL: https://github.com/apache/httpd-site/issues/31
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org