let's start in trunk! remove the old docs (they are still in 2.1) and let's write new ones or selectivly copy old docs over.
OK, but there must be a way to mark off the old docs as either "added" or "deprecated" to know when you're finished looking at the old docs.
a wiki page should be good enough.
-- Reinhard