added doc docs

For @makeclean, but I am sure others will benefit eventually too.