update docs for schemas