more docstrings, also allow for exact length for changeset shas