Pythonize me captin'
Made the method comments more pythonic by moving them
within the method definitions.