Cairo Production Release Checklist

Steps taken when preparing the Production CairoRelease.

Release Preparation

Status	Task	By	Comments
	Update TWiki.TWikiFuncModule of Beta installation with latest text generated by PerlDocPlugin	PeterThoeny
	Update AppendixFileSystem	PeterThoeny
	Create TWiki.TWikiUpgradeGuide based on CairoReleaseUpgradeGuide (rename current one to TWiki.TWikiUpgradeTo01Feb2003	PeterThoeny
	Proof-read TWiki web topics and sync to Beta	PeterThoeny	was a lot of work, all done now
	Update TWikiHistory based on CairoReleaseSummary	Main.
	Check file permissions of templates, bin, lib and pub/icn files	PeterThoeny
	Set final release date in TWiki.pm	PeterThoeny
	Bump release version up to new date in all TWiki topics	PeterThoeny
	Create final Beta release package for testing	PeterThoeny
	Update twiki/license.txt with new release version	PeterThoeny
	Update twiki/readme.txt text if needed (release version is updated by makedistrib script)	PeterThoeny
	Create release topic TWikiRelease01Sep2004 (start from TWikiReleases)	PeterThoeny	Removing "To be released shortly" note pending
	Create Known Issues topic KnownIssuesOfTWiki01Sep2004 (start from TWikiRelease01Sep2004)	PeterThoeny	Removing "To be released shortly" note pending
	Create advocay topic TWikiAdvocacy01Sep2004 (start from TWikiAdvocacy)	PeterThoeny
	Update ImplementationDate in WebForm with new release	PeterThoeny
	Update Plugins.TestedOnTWiki with new release	PeterThoeny
	Update Known Issues link in Support.AskedQuestions and Support.OlderKnownIssues with new release	BerndRaichle
	Prepare press release	PeterThoeny

Release

Status	Task	By	Comments
	Create production release package with p switch	PeterThoeny
	Create tar-ball version	PeterThoeny
	Update release index.html file	PeterThoeny
	Copy package to download location	PeterThoeny
	Download package, then mirror to www.thoeny.com domain	PeterThoeny
	Announce in DevelopersNews	PeterThoeny
	Update download screen	PeterThoeny
	Send press release	PeterThoeny

Post Release

Status	Task	By	Comments
	Decide code name of follow up release and create topic (AthensRelease, BeijingRelease...)	many	DakarRelease and EdinburghRelease
	Update Codev.WebHome, WebLeftBar, WebPreferences with known issues link and code name topic link	PeterThoeny
	Update TWikiProductionRelease	PeterThoeny
	Announce TWiki-Dev list	PeterThoeny
	Announce to list of Beta users	PeterThoeny
	Announce to list of production users	PeterThoeny
	Announce new release to SF and Freshmeat	PeterThoeny
	Announce new release to other web sites	all	Use the TWikiAdvocacy01Sep2004 to spread the word!

-- PeterThoeny - 08 Aug 2004

Help needed:

On step "Prepare press release", I contacted some companies and asked to contribute a sentence or two on how TWiki helps employees work together better. It would be great to get a testimonial from someone in VP level at a well known company. So far no luck. Any help in this field is greatly appreciated. See previous example at TWikiAdvocacy01Feb2003

-- PeterThoeny - 08 Aug 2004

One task not mentioned is to alert all plugins authors that the API has changed and they need to test against the Cairo beta.

Might be an interesting way to discover which plugins are still maintained!

-- CrawfordCurrie - 15 Aug 2004

I am not aware of changed Plugins API. We added many new functions and callbacks. What is incompatible?

-- PeterThoeny - 15 Aug 2004

getGmDate is the one that might catch people out. But aside from that, not the plugins API; the core API, especially the regexps. Several core API calls can now be replaced by plugins API extensions. And ideally, all plugins should be tested against the Cairo beta before Cairo release. It would be much crisper for end users if everything worked out of the box.

I'll re-run the conformance tests against the SVN head. That way we should be able to tell what might be impacted.

-- CrawfordCurrie - 16 Aug 2004

In TWikiFuncModule, formatGmTime is deprecated but still available. The new function to use is formatTime.

Plugins authors have been warned in many places not to use unofficial TWiki functions. So, back to the drawing board for those who did... (I am aware that the API is/was not sufficient for some needs)

-- PeterThoeny - 17 Aug 2004