Jeremy Ashkenas

Feel free to give it a try, and try to make it nice — if it's clean enough, and doesn't force non-windows users to download node-glob (which they won't need),...

> I don't like the fact that comments that are within functions, i.e. indented, are pulled out as text. Should there be an option to control this? No. Many of...

Yes, they should be. But Docco is open source. Feel free to change it as you like to make documentation as you like.

My thoughts: - How do you determine which comments stay inline, and which go outside? Some funky formatting or tagging? Why force the reader to bounce back and forth? -...

No. Most of your comments are probably indented at least a little bit. Just because something is happening inside of a function doesn't mean it's not important or unworthy of...

Aaaaah, for `.litcoffee`. It's Literate CoffeeScript. I thought that when you said literal CoffeeScript, you meant literal, CoffeeScript. Yes, good point, that would be nicer.

Make it the default. Just make it work.

> Should I send a PR Go for it. That way you'll get the credit.

Ugh!

Nope. You're not missing anything. It would be ideal if Python (and other languages) _did_ support that `.py.md` file some day ... a boy can dream. My hesitation on adding...