On Friday, April 4, 2003, at 08:33 AM, Bertrand Delacretaz wrote:
1) There must be a way for users to know if a given version of a wiki doc has been reviewed/validated by committers, and by whom, so they can estimate the reliability of the document.
(I have ideas for this based on status files stored in CVS and dynamically read by a JSPWiki plugin from viewcvs, but let's not talk about tools ;-)
Ok, let's try. However, this might be hard to do consistently, especially with docs that relate to a particular configuration. Plus, what if a user introduces something incorrect after it's been validated? I know they could check diffs against a validation date, but, that starts to get complicated.
It might not be that hard if the wiki page revision has a unique ID (maybe simply the file time), then we could have a status file in CVS like
SomeFunnyWikiPage 2002-02-14 12:04:06 user:joe version:2.1 comments:intro needs some work, but otherwise ok
Which could be translated to a small status table in the wiki page (after being pulled from CVS by JSPWiki over the viewcvs interface), in a different color if the file date is not what is in the status file anymore. "joe" is the committer who validated, "2.1" is the version against which this page was validated and the rest are comments.
This needs a JSPplugin to produce the status table but IMHO is not too hard to maintain.
Maybe using a java properties file for the status file would make the plugin implementation easier and more flexible.
Well, it's my understanding we could Forrestize wiki docs, say for a release publication need, by parsing the structured text contained in jspwiki.fileSystemProvider.pageDir. Now of course, you could embed a tag with this version content within the editable page text, as per variables shown in pages like SystemInfo, but that would require users to include this tag every time they set up a new page. How would you handle this?
Diana
