Add docstring conventions to README.md.

We're not really using them yet, but I just started using
them for documenting parameters and think we should use
them more going forward (see http://stackoverflow.com/a/10065932).