Done throughout using the convention of

Args:
  foo: type. Description.

for types since that's easier to parse programmatically than mentioning the type as part of the description, like http://google-styleguide.googlecode.com/svn/trunk/pyguide.html does.

https://github.com/edx/edx-platform/wiki/Python-Guidelines mentions the old style; maybe it could use a refresh?