H.vanderLinden wrote: > David Crossley wrote: > > Good idea and i admire your enthusiasm. > > Thanks. > > > You will see my additions to that page were i tried to ensure > > Yes I noticed. > > > that it only links to local Cocoon documentation. Already i see > > that people are not heeding that, and linking off to all sorts of > > remote stuff. It may end up just being a jump page to everything. > > Well, at first I like this page to be a kind of inventory to available and > missing documentation. After that I think it needs to be structured, with > some pages possibly rewritten and end up in the xdoc section. My ultimate > goal is an ebook kind of documentation.
Great idea. This is then orthogonal to the total restructuring of the xdocs, which was shelved until 2.2 because it would otherwise break our URL space. I would certainly like to see this ToC cater for the anticipated "Reference documentation" (cannot find old dev@ or old docs@ discussion yet). > Part of the documentation in my view is also a section on "Cocoon info in > the rest of the world", although this might very well be a wiki page. Well i think that we should start that now, then keep this page clean. One thing that we had discussed about Cocoon core xdocs documentation was that it should not appear to sanctify any external documentation, because there is some stuff out there that we may not be happy with and where do we draw the line. Also we do not want to get into URL management and dead links. So yes, a separate Wiki page sounds better. > > Please also scan the dev@ and the old docs@ archives. > > This TOC topic has been discussed and commenced many times. > > :-) I'm sure it has, I'll have a look. > > > I think that such pages will need very clear intentions and > > monitoring to keep on track. > > Is the above clear enough? That helps a lot thanks. There is one aspect that i am still not clear about. Do you envisage that this ToC itself would become an xdoc? I hope so. If so, then that is why i would like it to be free from references to external cocoon-related stuff. --David
