[Adium-devl] Early Returns and the Coding Style Docs

[Patrick Gibson]

Yes, it's sadly true that it got put on the back burner once more, in  
favor of far less interesting school work.

That's not to say I haven't been playing around in the Adium code – I  
have, and am slowly getting my bearings. It is huge though,  
especially for just a Cocoa novice like me, so I expected it take  
some time. (I just didn't expect it to get so delayed.)

On the upper hand, summer is just around the corner. I hope to not  
only hope to still be close tickets, but be closing tickets with  
patches. :)

Sincerely,
Patrick G.


On 28-Mar-06, at 1.28PM, David Smith wrote:

> On Mar 28, 2006, at 10:21 AM, Colin Barrett wrote:
>
>>
>> On Mar 28, 2006, at 12:28 PM, Evan Schoenberg wrote:
>>
>>> but use your judgement for what makes the code easiest for a
>>> newcomer to follow.
>>
>> What's quoted above is possibly the most important thing in this
>> thread so far. That's the whole point of our coding style
>> guidelines: to make the code easy for a newcomer to follow. This is
>> accomplished in several ways: a consistent indentation and bracing
>> style to make things visually pleasing, creating a standard for
>> naming so that form can then imply function, and discouraging the
>> use of confusing and obfuscating coding practices.
>>
>> Speaking of making the code easier for newcomers to read, is
>> documenting the undocumented sections of Adium going to happen,
>> ever? I'd like to see it by 1.0, but I dunno how feasible that is.
>> I'm willing to lend some time--indirectly by writing better
>> documented logging code, and directly by actually documenting
>> undocumented classes.
>>
>> -Colin
>
> 	Patr1ck was thinking of doing some documentation work, but I haven't
> heard him mention it in quite a while.
>
> 												David
>
>
> _______________________________________________
> Adium-devl mailing list
> Adium-devl at adiumx.com
> http://adiumx.com/mailman/listinfo/adium-devl_adiumx.com

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://adium.im/pipermail/devel_adium.im/attachments/20060328/d6c65fe5/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: PGP.sig
Type: application/pgp-signature
Size: 186 bytes
Desc: This is a digitally signed message part
URL: <http://adium.im/pipermail/devel_adium.im/attachments/20060328/d6c65fe5/attachment.sig>