On 07/08/13 11:22, Claude Warren wrote:
I have been thinking about this a bit more and am of the opinion that any
new documentation should be "within" the current website and therefore the
WIKI may not be the best solution.
Perhaps the easiest start would be to create a section titled "Usage and
Design Patterns" in the site under the documentation section. I would
propose that we place in this section items that are either longer than the
"howto" currently found in the "notes" section or that span multiple
components.
Some thought needs to be given to navigation, especially as Samuel
Croset is suggesting a change to the site IA as well as the look and
feel (as far as I know, comments about the navigation structure below
the top-level are as-yet unresolved in Samuel's redesign).
Documents in this section would be accepted in two basic formats:
1) web (mdtext/html), may be multiple pages.
2) downloadable (pdf?), must include a single web page describing the
document and providing the link to the download which would be in the jena
documentation directory.
What's the use case for having downloadable pdf documents? Apart from
being less accessible to users and to search engines, they're also hard
for anyone other than the original author to maintain. So for me: +1 to
contributions in mdtext or html (and I suggest that raw html should be
converted to mdtext using one of the many tools), -1 to pdf.
Ian
