Currently the section about the old API is placed in between up-to-date documentation and makes it pretty confusing to see what is old and what is new.
Any objections? Alternatively we could put it all the way to the end or in a separate document.
-Felix