Writing long overdue doc, its not a pretty job, but someone has to do it :p