improve documentation of actions. other doc improvements