Mailing-List: contact general-help@xmlgraphics.apache.org; run by ezmlm
Precedence: bulk
Reply-To: general@xmlgraphics.apache.org
Received-SPF: pass (nike.apache.org: domain of bowditch_chris@hotmail.com
 designates 65.55.111.151 as permitted sender)
Message-ID: <BLU0-SMTP396D5D6D2A6D659216EA469FB3F0@phx.gbl>
Date: Tue, 17 Apr 2012 09:19:59 +0100
From: Chris Bowditch <bowditch_chris@hotmail.com>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
 rv:11.0) Gecko/20120327 Thunderbird/11.0.1
MIME-Version: 1.0
To: general@xmlgraphics.apache.org
CC: fop-dev@xmlgraphics.apache.org
Subject: Re: on changing fop documentation sources to markdown
References: 
 <CACQ=j+dXthfNYX1iHO9SOg21g0uO1tEkk+=6VvUzATPu3La1-w@mail.gmail.com>
 <D6F348F9-7014-4521-BE17-409E7265F24E@gmail.com>
 <CACQ=j+fcLUQsXMNZkyzyrdUrMEr4o-4Sj=TMSA2bKpWanu2Vew@mail.gmail.com>
 <CANooF-g+2Xm-YRVk_LS+Q8yKUpc2BsubK+Ymr614XS=LAm_7RQ@mail.gmail.com>
 <CACQ=j+d8HpoJJ0yEdWsB4RT7JvWuK4-zLFMyoT0s4UJieJv-4w@mail.gmail.com>
 <419173C8-DDC0-4F9D-9C07-D7FAD6BCC21F@gmail.com>
 <CACQ=j+dPugJfH2o5qthq+oe13nxkzQUGDXV6cuqWiRqCZBU9SA@mail.gmail.com>
 <4F869BD0.9020709@gmail.com> <BLU0-SMTP459404CF2A10CFE7327933AFB3A0@phx.gbl>
 <CACQ=j+derNEenaLYxE=w432EoQ6zvAnvTu7ixJV4E4MggjMwWg@mail.gmail.com>
 <D7645943-0357-48C7-8A82-86A2583293D4@gmail.com>
 <CANooF-gMr75z4ao1c2quA3Z3CwudPj2PB6Q6keB=avkXM9TLWQ@mail.gmail.com>
 <CANooF-gyeAqsKcNXMb0UXk+obVmz-hW1-_pdhgTorbG_B2njAw@mail.gmail.com>
In-Reply-To: 
 <CANooF-gyeAqsKcNXMb0UXk+obVmz-hW1-_pdhgTorbG_B2njAw@mail.gmail.com>
Content-Type: text/plain; charset="ISO-8859-1"; format=flowed
Content-Transfer-Encoding: 7bit

On 15/04/2012 19:52, The Web Maestro wrote:
> I just added most of the nav for FOP Development (0.95, 1.0, trunk/ 
> and 'dev'):
Hi Clay,
>
> http://xmlgraphics.staging.apache.org/
>
> As mentioned, there are likely missing things (like java-docs, 
> download.cgi, Batik's DEMO, etc.)... It'd be great if folks could take 
> a look... I haven't figured out how to add other content, but It Might 
> Just Work(tm) if weupload it there via SVN...

Many thanks for working on this.

>
> Come to think of it, we should probably move this to 
> general@xmlgraphics.apache.org 
> <mailto:general@xmlgraphics.apache.org>. Or is there a better mailing 
> list? I'll refrain from sending to other lists, until we figure out 
> where it should go.
>
> Any ideas where this discussion should move, since it entails changes 
> to all XML Graphics Project web docs?

Yes this discussion should move to general@ as it will affect all sub 
projects of XML Graphics.

Thanks,

Chris

>
> Kind regards,
>
> Clay Leeds
> --
> <the.webmaestro@gmail.com <mailto:the.webmaestro@gmail.com>> - 
> <http://ourlil.com/>
> My religion is simple. My religion is kindness.
> - HH The 14th Dalai Lama of Tibet
>
>
> On Sat, Apr 14, 2012 at 11:53 PM, The Web Maestro 
> <the.webmaestro@gmail.com <mailto:the.webmaestro@gmail.com>> wrote:
>
>     I've updated the docs a bit, and gotten much (but not all!) of the
>     FOP, Batik & Commons content into the CMS...
>
>     We're still missing an adequate navigation system, so I did a
>     preliminary job of getting a few links in the sidenav, but it's
>     incomplete and ugly as sin. We'll need to build a mechanism to
>     hide (collapse?) non-relevant links, but that shouldn't be too hard.
>
>     We also need to figure out java-docs, download.cgi, and perhaps
>     some other issues...
>
>     Without further ado:
>
>     http://xmlgraphics.staging.apache.org/
>
>
>     Kind regards,
>
>     Clay Leeds
>     --
>     <the.webmaestro@gmail.com <mailto:the.webmaestro@gmail.com>> -
>     <http://ourlil.com/>
>     My religion is simple. My religion is kindness.
>     - HH The 14th Dalai Lama of Tibet
>
>
>     On Thu, Apr 12, 2012 at 10:03 PM, Clay Leeds
>     <the.webmaestro@gmail.com <mailto:the.webmaestro@gmail.com>> wrote:
>
>         On Apr 12, 2012, at 6:41 AM, Glenn Adams <glenn@skynav.com
>         <mailto:glenn@skynav.com>> wrote:
>         > Agreed that removing forrest dependency is desirable.
>         However, presumably the current xdocs would need to be
>         converted to MD, in which case someone will need to construct
>         an XSLT to do so. That begs the question of whether it would
>         be necessary (at this time) to convert the source format to
>         MD, or if an additional step in the CMS based process could
>         merely perform that step automatically. If so, then it should
>         not be necessary to change the authoring format at this time.
>         It could be done as a separate step later.
>
>         I am using Forrest 0.8 w markdown plugin. Conversion could be
>         scripted, but that would negate the benefit of the CMS.
>
>         > What I don't know yet is what we will lose from the
>         conversion to MD in terms of ability to markup our source
>         docs. Clearly, MD is not as semantically or syntactically rich
>         as an XML based source. But do we lose anything of
>         consequence? I don't know yet.
>         >
>         > One thing we may lose if we don't convert to MD is the
>         ability to use CMS in-page editing. So that is a
>         consideration. Perhaps that option is sufficient to justify
>         other potential negatives in converting.
>         >
>         > G.
>
>         One of my goals, was to see some discussion in the DEVers,
>         before I complete the task of converting the docs. The
>         MarkDown format is not nearly as semantic as xdoc, but it
>         serves a different purpose.
>
>         It'll take some time, and I'm still prepared to take it on.
>         But I was hoping for some discussion ;-)
>
>
>


---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: general-help@xmlgraphics.apache.org