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: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to