doc updates for #49 and #118