improving documentation

Explain why the padding argument must be an integer, and move that
section from the instructions into the “Notes” section.