Condense docstrings and add @param notation

Revise and condense docstrings to align with other elements of Buildbot code.