Stuff. Fixes quicksilver/quicksilver#536

Basically, fixes quicksilver/quicksilver#536 and added documentation.
Writing documentation went on and on and on... I can't believe we've never described docking windows before! :/
There's probably something missing/typos so just say