offby1 / rudybot

Just what the world needs: another IRC bot
55 stars 12 forks source link

Few source code comments #13

Closed snogglethorpe closed 12 years ago

snogglethorpe commented 12 years ago

❝Across all Scheme projects on Ohloh, 10% of all source code lines are comments. For rudybot, this figure is only 4%. This lack of comments puts rudybot among the lowest one-third of all Scheme projects on Ohloh.❞

lowest one-third!

https://www.ohloh.net/p/rudybot/factoids/18185952

offby1 commented 12 years ago

I'd add comments to specific bits if anyone asked me to, but I sure as **\ ain't gonna just add 'em willy-nilly to satisfy some automated thingy that I've never heard of.

snogglethorpe commented 12 years ago

ok, ok; point.

Still...

[Minimum one-line comment per function (";; This function mulches the rarg and returns its blitz; urds are ignored.") is a habit that was well beaten into me when working for the FSF. I find it difficult to write code without doing that now...]

BTW does rudybot run anywhere except #emacs...?

offby1 commented 12 years ago

On Thu, Mar 29, 2012 at 9:18 PM, Miles Bader reply@reply.github.com wrote:

BTW does rudybot run anywhere except #emacs...?

I generally have it in #emacs, ##cinema #scheme and #racket.