More writeups

let me know if the commit message is still not good enough! :)