That's a good one. I do the same in code documentation. One line to very briefly summarize what that function/module does, <enter><enter>, followed by a more detailed description.