Re: Samples Refactoring: Documentation Structure

[David Crossley <cr...@indexgeo.com.au>]

Someone said:
> > I'd like also to propose some requirements/wishes to samples
> > organization.
> > They should:
> > - have a subsitemap where all the used (specific to the sample)
> > components are declared
> > - provide a default access URI (like: /samples/i18n/, /samples/jsp/)
> > - provide 'View source' links (where possible)
> > - provide 'View sitemap source' link
> > - can have also links to according docs, howtos, etc.

Today i refactored one of the old samples, entity-resolver.
While i was doing that i noticed that some documentation is
starting to appear for certain other samples. However, that
documentation is local to the samples, rather than being
over with the main documentation xdocs, e.g flow, xmlform

It would be better to provide really basic documentation
under samples which links across to the main documentation.
Otherwise all of this useful documentation is not available
in the main xdocs and the user can only see it via Samples.
--David






---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org