updating docs for square-bracket notation