better explanation
better docs for read numbers