Documentation updates suggested by @embray