Adding docs for PUT modifications

Also: cleaning up a little bit.