vlion: magical weaponized pony! (weaponized pony)
vlion ([personal profile] vlion) wrote in [site community profile] dw_dev2010-03-02 02:24 pm
Entry tags:

documentation

Hi,

I'm looking for a non-coding project to help out with that can be done in chunks. (I do programming work basically 40 hrs/wk). denise suggested documentation.

What files can use some documentation?
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

[staff profile] denise 2010-03-02 11:04 pm (UTC)(link)
Oh God, having comments on every function in User.pm saying what it does, what it expects as args, etc, etc, would make me weep for joy.

Tears. Seriously. Of joy.

(..also, if it were combined with checking to see if any of the functions aren't called anywhere anymore ... or did we already do that?)
Edited 2010-03-02 23:05 (UTC)
exor674: Computer Science is my girlfriend (Default)

[personal profile] exor674 2010-03-02 11:29 pm (UTC)(link)
I'd totally love if it was all POD too, cause http://hack.dreamwidth.net/dev/docs/LJ/User.html = very yay

( p.s. whoever does that, make sure my patch on http://bugs.dwscoalition.org/show_bug.cgi?id=2422 is applied first as that adds headers to each section, and use =head3 for the methods )
pauamma: Cartooney crab wearing hot pink and acid green facemask holding drink with straw (Default)

[personal profile] pauamma 2010-03-03 05:48 pm (UTC)(link)
Yes to PODifying. (And in fact, that could be a good thing to work on too, in addition to/instead of documenting the overall design and functioning of large things like ESN.