updates

(mostly documentation)