In the TWiki web, there are now files
TWikiReleaseNotes04x00
,
TWikiReleaseNotes04x01
, etc.
While I would not keep the old release notes, it is ok if you want to. However, there should be one file
TWikiReleaseNotes
which is the current one. The user should not have to figure out this
NNxMM
numbering scheme.
If you really want to keep old release notes around, I would suggest to have one long file and just keep prepending the newer notes. But then I would ask, why not have Athens, Beijing, and Cairo release notes there also?
--
TW
Good point. We could do it similar to the installation guide: Have one and the same name (as you suggest), and make the previous ones available on twiki.org's TWiki web as historical documents.
--
PTh
So is the decision to go with
- a single current release note or with
- s single consecutive release note?
--
TW
On TWiki.org this all makes sense. We can make a
TWikiReleaseNotes that index all the others.
In the distribution we normally only have the latest and it is also the only one that gets translated into HTML and placed in the twiki root when we build TWiki. But I decided to keep the 4.0 note also because 4.1 is a minor release and does not really have that many new enhancements. The 4.0 however had quite many new features - some which requires work for the upgrader. I find this a useful resource.
The reason why we have had users being confused is that 4.1.0 was released with a link to the 4.0 release note in
TWiki. This is now fixed.
I have added a note in the 4.0 release note that it is not the latest and why it is there. and with a link to the 4.1 note.
That should clear our any more mistakes.
--
KennethLavrsen - 04 Feb 2007