incubator-jena-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Andy Seaborne <>
Subject Re: Jena documentation
Date Wed, 16 Feb 2011 17:07:54 GMT

On 15/02/11 09:26, Dave Reynolds wrote:
> On Tue, 2011-02-15 at 00:29 +0000, Ian Dickinson wrote:
>> With respect to the IA, I think that the move from SF/OpenJena is a good
>> opportunity to revisit the structure of the Jena documentation overall,
>> and try to make it a bit easier for core constituencies to navigate. For
>> me, these are: new users, old hands and (potential) committers. Each
>> group has different needs. I'll make some initial suggestions in a later
>> message, but all ideas on this are welcome.
> +1
> We'll need to be careful not to get too ambitious. So long as we have a
> clean top level structure and can do an initial population from existing
> content then improvements can happen incrementally.


>> Assuming we stick with the Apache CMS, which uses markdown, I've had a
>> quick look at tools for converting HTML to markdown. There are several
>> around - I tried one: pandoc. Pandoc did a reasonable job, except for
>> tables (which aren't directly supported in markdown, though you can
>> embed html table syntax in markdown document).
> Just an aside but most markdown implementations I've come across also
> support markdown extras which does support tables [1]. Does the Apache
> CMS not have this?
> Dave
> [1]


View raw message