Roger Leigh <rle...@codelibre.net> writes:

> Mentioned briefly a few months back, but we could take the Git migration as
> an opportunity to convert the old StyleBook XML to Markdown and move the
> docs to github pages, generated directly from git automatically.

I assume the "github pages" part is acceptable to Apache due to the
recent announcement?


> I would certainly be happy to do the conversion, if there was consensus for
> doing so.

Yes, please. I doubt anyone will object but I think we will need a
vote to be compliant with the Apache way.

I also think we can drop any mentinoning of 2-series during this
conversion. There are, however, other bits of the documentation
(like Doxygen-generated). Here is step #15 that I mentioned:

15. Update the website by taking a binary package and extracting the 
    doc/html directories. The web pages are stored in 
    /www/xml.apache.org/xerces-c. You will also need to update the
    documentation pdf in the pdf directory (which has both a pdf and
    pdf.tar.gz). Recommend copying the new documentation over the
    existing files. Be sure to change the permissions on the files
    and directories:

    find . -type f -exec chmod 664 {} ;
    find . -type d -exec chmod 775 {} ;

    If the binaries are for different platforms you may also need to 
    update the download.html file to point to the new binaries.
    Verify that the website is updated (may take a while to be 
    refreshed on the real webserver).


---------------------------------------------------------------------
To unsubscribe, e-mail: c-dev-unsubscr...@xerces.apache.org
For additional commands, e-mail: c-dev-h...@xerces.apache.org

Reply via email to