Im looking to improve my mostly non-existent documentation when writing PHP. Ive purchased some books to refresh my knowledge on UML (which I havnt used since my college days and STD (State Transition Diagrams) seem to have been retired, as there is no mention of them anymore).

Does anyone have any decent documentation tutorials/books etc they could point me in to get going?

I know I could do a quick google search, and some smart alac Im sure will suggest it, but Im after recommendations of good books/tutorials.

Thanks in advance
Who is Participating?

[Product update] Infrastructure Analysis Tool is now available with Business Accounts.Learn More

I wear a lot of hats...

"The solutions and answers provided on Experts Exchange have been extremely helpful to me over the last few years. I wear a lot of hats - Developer, Database Administrator, Help Desk, etc., so I know a lot of things but not a lot about one thing. Experts Exchange gives me answers from people who do know a lot about one thing, in a easy to use platform." -Todd S.

Dan CraciunIT ConsultantCommented:
Not a book or a tutorial, but have you tried phpDocumentor?
DocBlocks are pretty much standard, AFAIK.

Ray PaseurCommented:
What Dan said.  Documentation after the fact almost never occurs, and some shops I've worked in require a code review of the DocBlocks before you write the code.  Additionally, unit testing tools rely on information in DocBlocks.  And if you've done them right, there are programs that will scan your code and create documentation manuals from the DocBlocks.  The Wiki explains it all:

Experts Exchange Solution brought to you by

Your issues matter to us.

Facing a tech roadblock? Get the help and guidance you need from experienced professionals who care. Ask your question anytime, anywhere, with no hassle.

Start your 7-day free trial
It's more than this solution.Get answers and train to solve all your tech problems - anytime, anywhere.Try it for free Edge Out The Competitionfor your dream job with proven skills and certifications.Get started today Stand Outas the employee with proven skills.Start learning today for free Move Your Career Forwardwith certification training in the latest technologies.Start your trial today
Project Management

From novice to tech pro — start learning today.