Issue

Pointed out by @franck44 and @protolambda, it would be more readable if we can more it clear of what are the preconditions of each function.

How to solve it

Add more detailed comments about the pre-conditions.

/cc @protolambda feel free to update this issue content. :)