[drupal-docs] Venting - do not read

[puregin]

Hi Judah - are you concerned mainly with core code, or contributed code?

There was a discussion some time about about putting contributed code 
through PHPDoc and displaying the results on drupaldocs.org, as the 
core module code is.   I think this would be a good start.

What kind of documentation would best fit your needs and learning style?

Djun



On 11 Jun 2005, at 9:12 PM, judah wrote:

> <rant>
> I've been trying to learn the drupal code and structure for a long time
> now and none of it is commented on. It's frustrating and terribly hard
> to learn. Why can't someone put a simple comment before functions or
> where the procedures shift like so,
> // This function renders the profile edit page. Also /user/3/edit
> Is there some reason we can't put comments inline with the code???
> Grrrr...
> <rant/>
>
> Hi Guys,
>
> Is there any initiative to document the module code?
>
> Best Regards,
> Judah
>
>
>