Nice to have single line summary followed by multiline detail:

https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt#id6