Would you like docs with that?

Stefan Koopmanschap (26.Feb.2010)
Talk at PHP UK Conference 2010 (English - UK)

Rating: 4 of 5

For most developers, documentation is a necessary evil they'd rather skip. But really, is documentation that evil? Or is it actually useful? This presentation with show the types of (technical) documentation that can be written, the reasons for documenting, and the tools that you can use to ease the documenting task.

Who are you?

Claim talk

By clicking this button you are declaring that you are the speaker responsible for it and a claim request will be sent to the administrator of the event.

If the claim is approved you will be able to edit the information for this talk.

Are you sure?

 
Comments closed.

Comments

Rating: 4 of 5

26.Feb.2010 at 11:44 by Thijs Feryn (140 comments)

Good reminder on the fact we SHOULD document our projects. Also good to see that non-conventional ways (commit messages, issue tracker, ...) of documenting have an impact as well.

Rating: 3 of 5

26.Feb.2010 at 11:46 by Dom Udall (6 comments)

Good points on commit messages, unit tests and FAQs, though nothing new to take away, good for the basics.

Rating: 4 of 5

26.Feb.2010 at 11:46 by Felix De Vliegher (30 comments)

Interesting overview of all means of documenting a project. Sometimes a bit hesitant when presenting, but that's normal for a new talk. Well done, Stefan!

Rating: 4 of 5

26.Feb.2010 at 12:07 by sb (1 comments)

Good presentation on the general jist of documenting a project from start to finish.

On a side note: Although grey fonts on a projector aren't that easy to read.

Rating: 4 of 5

26.Feb.2010 at 14:22 by Tom Claus (6 comments)

Nice and clear presentation about docblock, commit messages and FAQ's with a lot of very handy tips for our new projects.

Looking forward to see other presentations of you Stefan !

Rating: 4 of 5

26.Feb.2010 at 16:38 by Ketan Majmudar (7 comments)

Important and essential stuff which I wish I hasn'tisswd the beginning of..more please

Rating: 5 of 5

27.Feb.2010 at 07:55 by Chris Sedlmayr (45 comments)

A very complete presentation offering good tips thy we can all benefit from!

Rating: 5 of 5

27.Feb.2010 at 12:11 by Marcus Baker (6 comments)

Really surprised how good this talk was. Laid into some PHP code bases in a way that was long overdue.

Rating: 2 of 5

27.Feb.2010 at 12:25 by Martin Ledgard (6 comments)

Would have liked more detail on the technical docs. The functional part at the begining seemed more aimed at one man bands rather than developers.

Rating: 4 of 5

27.Feb.2010 at 12:43 by andrea m (5 comments)

It didn't teach me anything I didn't know already, which is scary because even though I know about lots of best practices I rarely apply them so shame on me!

Rating: 4 of 5

01.Mar.2010 at 11:03 by Craig Willis (5 comments)

Although I use most of the things he talked about already, was still interesting to know that another developer does that same!

Rating: 4 of 5

01.Mar.2010 at 11:11 by Pim Campers (4 comments)

In agreement with catchamonkey:
A very complete presentation offering good tips thy we can all benefit from!

Rating: 1 of 5

01.Mar.2010 at 12:53 by Paul Lomax (3 comments)

I found it a bit basic to be honest, nothing new.

© Joind.in 2014