docs update
[fixes #6] using 1-based positions instead of 0-based ones