Jump to content


Welcome to IPS!

Feel free to browse our community to get a feel for how our community software operates. Post in the pre-sales forum with any questions you have before purchasing or use the Test Posting forum to post a few messages yourself! You can also get a free demo to try the IPS Community Suite yourself.

Already an active IPS client?

Login with the same email address and password you use for the client area to access client-only areas.





Photo * * * * * 2 votes

PHPDoc Developer Documentation

Posted by bfarber, 15 January 2010 · 302 views

We'll keep this blog entry short and sweet, since there's not a whole lot to say.

Developers have asked for further documentation of IP.Board (and addon applications), specifically source code-level documentation of the various classes and methods that can be reused. Those of you familiar with phpdoc will know that it's the perfect tool for the job, and thankfully we wrote IP.Board 3 using phpdoc-style comments to facilitate this job.

After a lot of cleanup and tweaking, we have made the phpdoc developer documentation available for all. Please be aware that this is the first "release" of these documents, and there are likely going to be some oddities and under-documented functions. Please let us know where we can expand on the documents. We intend to add more code examples and to clean up the class-level documentation a little over time, but if you have any specific requests we'll focus on those first.

http://community.inv...docs/index.html




Nice!!!
Yay! :)
You just made my day :)
Thanks a lot :thumbsup:
i really like the last updated dates working in it ;).
Finally. :D nice work. :)
This is fantastic and will be a great reference! Thanks!

..Al
Do you think you could switch to Doxygen? Unlike phpDocumentor, it's actually still being updated and will already read the same code comments you've already made.

Tim Dorr, on 16 January 2010 - 08:00 PM, said:

Do you think you could switch to Doxygen? Unlike phpDocumentor, it's actually still being updated and will already read the same code comments you've already made.

i've already spoke to bfarber about this and he is interested in it and promised to have a look @ it when he gets some free time. For the time being this is better than nothing. Doxygen also has search functionality which is good.
Thank You!
That's what I was waiting for! :) Thank you very much!
thanks, a downloadable zip would make it even better!
Thank you. This will save me us a lot of time. :)

Tim Dorr, on 16 January 2010 - 03:00 PM, said:

Do you think you could switch to Doxygen? Unlike phpDocumentor, it's actually still being updated and will already read the same code comments you've already made.

It's something I will look into when I have some spare time available. I'd guess that might be a couple months away, but it's on my todo list somewhere.
I'm going to kill brandon if he does another mass commit in the svn :whistle: :whistle: :whistle: :P

February 2012

S M T W T F S
   1234
56789 10 11
12131415161718
19202122232425
26272829   

Latest Visitors

Search My Blog