Writing documentation the easy way

Bram Vogelaar (21.May.2011 at 11:45)
Talk at Dutch PHP Conference 2011 (English - US)

Rating: 2 of 5

Tba

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: 2 of 5

21.May.2011 at 11:58 by Dennis C. (24 comments)

Not quite what we expected. It was more about user manuals, rather than code documentation. More talk preperation would have been nice, as we did not quite grasp your train (of slightly stockato) of thought.

Rating: 3 of 5

21.May.2011 at 13:14 by Stefan Koopmanschap (313 comments)

Ran a bit short which is a shame, but that can be fixed by extending it a bit. Perhaps managing the expectations by choosing a better session title would also be good.

Rating: 3 of 5

21.May.2011 at 14:50 by Lineke Kerckhoffs-Willems (77 comments) via api

It was a bit hard to follow the story. I guess the speaker was nervous and maybe not to well prepared. would have liked to see more about how docbook works and the benefits for using it for technical documentation.

Rating: 2 of 5

21.May.2011 at 19:22 by Onno Marsman (53 comments)

Also expected more about technical code documentation. The speaker was obviously nervous but not to the point where it became a problem. The speed of the content was too fast. The sheets, I think, were ok, but some sheets came and went without all the contents being handled. If you have sheets with bulleted lists make sure you mention and explain them.

Not that unpleasant to attend to, but I felt like a missed 80% of what you wanted to tell me.

Rating: 2 of 5

21.May.2011 at 23:26 by Rik Deuzeman (8 comments)

The title of the session was indeed misleading and should be something like 'Write multi-language manuals, the easy way'. I also thought, just like Dennis, it would be a session with technics and tips on writing code documentation easier and faster.
The speaker was indeed, visible, nervous, which made the session a bit hard to follow.

Rating: 2 of 5

23.May.2011 at 13:57 by Rudolf Leermakers (9 comments)

The abstracts sketched the wrong picture of what the talk was going to be about, also the subject was a bit off-topic for a PHP conference, so many people, including myself, felt a bit cheated, there probably where more interesting talks going on at that moment. Bram was also noticeably new and uncertain about presenting, this is not a bad thing, but improvement is very welcome, specifically the flow of the talk, don't pause for more than a few seconds, and try to engage the audience a bit more.

© Joind.in 2014