[minor] docs and specs