update docs and make sample 1 as index