ReadySET: How to upgrade
ReadySET is still in fairly early releases that are rapidly
evolving. The differences between any two early releases may be
quite large, making upgrading difficult.
As ReadySET matures (i.e., passes v1.0.0), the changes between
minor versions should become smaller and easier to upgrade.
Also, some of the ReadySET content that is most likely to change
and grow over time is not part of the templates at all, it is the words of
wisdom hosted on the ReadySET web site.
Low-Tech Upgrade Proceedure
You may simply cut and paste sections of HTML source code between
new ReadySET templates and files that you have been using in your
While potentially tedious and somewhat error-prone, this method
requires no training or specific tools. It also has the advantages
that it is very easy to update only as many or as few files as you
Check the release-notes.html in the new release of ReadySET for a
summary of changes.
High-Tech Upgrade Proceedure
For users that use CVS for their own project: you can use CVS's vendor
branch feature to help you merge the latest changes from the
ReadySET project into your project.
Let's assume that you are upgrading from ReadySET v0.8.2 to
v0.9.1. Let's also assume that you consider "Tigris.org" to be the
vendor of ReadySET. Note that CVS does not allow periods in tag
names, and we do not want ReadySET version numbers to conflict with
any version numbers of your projects, so we will make the names more
distinctive and use underscores instead: ReadySET_0_8_2,
Let's further assume that you are using a CVS server located at
cvs.yourcompany.com with a repository located at /cvs, your username
is username, and that you are using ReadySET for a project named
- Unpack ReadySET v0.8.2 and add it to your CVS
repository on a vendor branch.
cvs -d :pserver:firstname.lastname@example.org:/cvs import -m 'importing ReadySET v0.8.2' yourproject Tigris_org ReadySET_0_8_2
- Unpack ReadySET v0.9.1 and add it to your CVS
repository on the same vendor branch.
cvs -d :pserver:email@example.com:/cvs import -m 'importing ReadySET v0.9.1' yourproject Tigris_org ReadySET_0_9_1
- Create a working copy of your project documents (if you don't
already have one).
cvs -d :pserver:firstname.lastname@example.org:/cvs co yourproject
- Merge the differences between the two vendor
versions of ReadySET into your working copy.
cvs update -j ReadySET_0_8_2 -j ReadySET_0_9_1
- You are likely to see several messages from CVS about merging
files and conflicts. The CVS output lines that begin with "C"
- Edit your working copy files to resolve all conflicts. Browse
the files to make sure that they look OK. If any files have changed
names, you will have to cut and paste content from the old filename
to the new filename.
- Commit your updated files to your repository
cvs commit -m 'updated project documents to use newer ReadySET templates'
These steps are specific to CVS, but other version control systems
likely provide analogous functionality.