: I think a way to version the Wiki at the time of release would be really : helpful. I know it isn't directly related to this task, but I think it would : be really useful to have archives of the Wiki, since it is the main
Eh ... i'm not sure i agree with you on that one. i've always wished we could bundle the wiki with the releases but (as you know) there are legal issues beyond the solvable technical ones. having online "archival" views of the wiki almost strikes me as the worst of both worlds ... you have to be online to read it, but you don't gain any wisdom from updates after the release. if there was a feature in 1.2 that had a bug in it, but you were looking at the online archived 1.2 version of the wiki, you may not notice the big red flashing text warning you about a potential problem. while i wasn't that hot on the whole [Solr 1.2] syntax when people first started using it (because it seemed like it would be a nightmare to clean up after a few versions) it's definitely grown on me as a way for the wiki to always document the most current info, with little icons signifying important things to know if you are using specific versions ... but skimming info about newer versions can still be useful as (if for no other reason then to tell you about all the cool features you could have if you upgraded) The key is just to be consistent and methodical about annotating when stuff is available ... and in the long run, cleaning up annotations that are so old as to not be relevant. -Hoss