document everything and some very minor changes