Fixing vBulletin and bringing the hacker community back together.

[buro9]

Originally Posted by filburt1

The one thing they need to do is actually document their functions, preferably with PHPDoc style so I know what the hell each argument means...

That I agree with too.

I'd love more comments in their code too... really plain stuff, the obvious.
I was coding in C, C++ and PERL before picking up PHP, and it's a nightmare that first time you read a massive block of code and wonder what it's doing.

It may be repetitive, but I think that there is a lot that can be gained from highly commenting it, not least that it would make the code less scary to newbies who want to try their hand at hacking and are stuck wondering just what escape_slashes() does.

Then there are things like common tasks... I think the key pieces of functionality (send a PM for example) should be wrapped in a nice little developer API... so fewer hacks required code duplication or file changes... they could exist as seperate files and just call the API's... which of course should be highly documented.

We could take it upon ourselves to do some of that... but this is core product stuff, and I doubt anyone will install a hack that simply adds comments!