DOC/CLN: A few fixes and cleanup for doc warnings/errors

closes #5126.