Remove comments that are redundant with documentation strings.
Other improvements to documentation and formatting.