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] http://michelf.com/projects/php-markdown/extra/#table


Reply via email to