Sparse Documentation: pulse module

[garbagetrash]

Update documentation for the pulse module. In particular:

• Add single line descriptions where missing, and extended descriptions where necessary
• Add arguments sections where missing
• Add examples sections where missing
• Ensure all docs tests are passing

Use the util module documentation (or better) as a target for level of completeness.

[garbagetrash]

A first pass at this is available on the feature/moduledocs branch.