Update README.md

Suggest using PDoc comments over standard multiline comments, as they will get stripped out.