Simone Gianni said the following on 09-05-2006 00:37:
Thanks Helma, I can't properly understand what has to be done on documentation : - should legacy docs be moved to the new structure?
Currently the legacy docs are used for the current Cocoon version i.e. 2.1.X. There are scripts that export the information from Daisy into the current version of the website.
The documentation collection/site will be used for the next Cocoon version 2.2, 3.0 or whatever the new release number will be. We can totally rearrange the documentation structure then if we want to.
When information currently in the legacy docs, is also valid for the new version of Cocoon, you can simply add the "documentation" collection to the document.
- will the new structure be published on the site instead of the current docs?
I think that eventually, when 2.1.X goes in maintenance mode, the current site will no longer be updated and the new 2.X/3.0 site will be added and extracted in much the same way we do now with the 2.1.X site.
- does it have any meaning to "backport" modifications to the legacy docs?
Yes, you will enhance the value of the document and bring it up to date for the 2.1.X branch.
Is there a "documentation status page" or something similar?
No, I don't think so. I've been meaning to start some Jira issues on what documentation tasks there are to be done, but I'm swamped here so I never seem to get round to do this.
Also, there is something weird in daisy on cocoon zones : when I look at a document somebody modified i can see "you are looking at the live version of this document, which is currently not the last version", but if i click on the "last version" link, i still see the same document, only the warning at the top of the page changes. I can see the last version only if I edit it. Is this the expected behaviour? This caused me a kind of shock the first time, I thought all I wrote has been lost :)
It does sound a bit weird that you don't see the true last version of the document, but you need to contact the Outerthought boys on that, I have no clue what could be wrong.
Bye, Helma
