doc: write hacking section on pylint and co

[laszewsk]

flake pep8 autopep8 pylint

[laszewsk]

http://docs.python-guide.org/en/latest/writing/style/

[laszewsk]

http://legacy.python.org/dev/peps/pep-0008/ https://pythonhosted.org/an_example_pypi_project/sphinx.html#code

[laszewsk]

http://www.pylint.org

[laszewsk]

I have not used this one http://www.logilab.org/blogentry/6883

[laszewsk]

we may ask REU students to do this, so dont work on this, do code

[laszewsk]

emacs https://github.com/jorgenschaefer/elpy/wiki https://bitbucket.org/agr/ropemacs

[laszewsk]

gedit https://wiki.gnome.org/Apps/Gedit/PylintPlugin

[laszewsk]

http://obroll.com/setup-aptana-for-python-and-django-development-with-checker-linter-tag/ step 2, 3 step 4 is probably different as we want more strict step5

[laszewsk]

evaluate http://blog.utopianlabs.com/2013/08/setting-up-aptana-for-python-coding/

[laszewsk]

pychecker pyflakes flake8

[laszewsk]

http://kwbeam.com/emacs-for-python-i.html

[laszewsk]

documentation on how to docuement a method and class

def format_exception(etype, value, tb[, limit=None]) """ Format the exception with a traceback.

:param etype: exception type :param value: exception value :param tb: traceback object :param limit: maximum number of stack frames to show :type limit: integer or None :rtype: list of strings """