Great work - this is definitely one of the things we ought to have at least some info on for developers :)
I'd say just move the page to the location you suggested, but maybe have a "draft" notice on top until Markus reviewed it.
Jeroen De Dauw
Don't panic. Don't be evil.