Write The Docs EU — Robert Lehmann — Self-Directed Learning Material

I’m at Write The Docs EU today in Budapest and will post semi–unpolished notes from sessions throughout the day after each talk finishes.

Don’t teach dogmatically.

Collaboration can kill cohesion, so choose one champion for the discussion.

Use the right tools and lightweight markup; they use Jekyll and Sphinx.

Begin with the end in mind. For example, when you start to explain a process, if you mention a few things that haven’t been covered before, backtrack and write that information in a new (earlier) chapter.

Encourage experiments so people can appreciate going through the exercise and learning from it. On a related note, “no pain, no gain”.

Being redundant is good, but being concise is better. Find balance between the two.

Translate verbatim and sheepishly. If you spot anything wrong, update the original source first.

How do they teach?

  • Teachers need to remember that “their keyboard is made of lava”. Instruct the students to do it.
  • Use the Socratic method. Don’t give answers. e.g. “Good question! What could you do?”
  • “Feedback is the breakfast of champions.”

For more information, see Coaching Guidelines.

Published by

Bryan Villarin

Bryan works at Automattic. Cat whisperer. Sometimes, a photographer and card magician.

Talk to me, Goose

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s