Various doc improvements

Adds and clarifies docs.