xmlgraphics-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Glenn Adams <gl...@skynav.com>
Subject Re: documentation!???
Date Sun, 10 Feb 2013 21:03:34 GMT
On Sun, Feb 10, 2013 at 10:50 AM, Clay Leeds <the.webmaestro@gmail.com>wrote:

> Hi folks,
>
> I've eradicated Forrest-based documentation from FOP. Now we need to
> ensure that FOP builds properly.
>
> BTW, I also need to do the same for Batik and XML Graphics Commons, but I
> thought I'd wait until other folks had a chance to ensure I didn't munge
> stuff!
>
> As for getting documentation into their respective project sources, I'm
> thinking of one of the following:
>
> 1. svn hook to copy the MarkDown docs *to* their respective location
> *from* the current 'ASF-CMS' (vice ;-)
> 2. svn hook to copy the MarkDown docs *to* the current 'ASF-CMS' *from*
> their respective location (versa ;-)
>
> I suspect the desired approach would be #2, but the ASF-CMS system is
> geared toward editing the docs in ASF-CMS, which would make #1 easier.
>
> Another possibility would be to somehow create a system to copy the
> rendered HTML output to the repo…
>
> Thoughts? Preferences?
>

My preference is #2, i.e., to keep the doc sources in the same repositories
as their non-doc sources. I have to wonder what other projects are doing
about this?

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message