ENH: define some pylint expectations explicitly (pylintrc file); closes #562

- also elaborate caveats about using pylint
Merge pull request #569 from jeremygray/master

ENH: define some pylint expectations (pylintrc file); closes #562