docs: align user docs and repo docs with implementation (#7)

docs: align user docs and repo docs with implementation (#7) #4