DOC: update docstrings, whitespace in diagnostics
DOC: update docstring for pca

Note parameter is optional