SlideShare a Scribd company logo
1 of 62
Download to read offline
Writing engaging tutorials
  Making them come back for more


                     Christian Heilmann
           Yahoo! Frontend Engineering Summit UK
                       December 2007

       http://creativecommons.org/licenses/by-sa/3.0/
There is no perfect tutorial.
… as there is no “one”
      audience.
One thing to keep in mind is
  the perceived speed of the
internet and the impatience of
          developers.
We are much more patient
when it comes to assembling
 a plumbing unit in our flat
than when it comes to using
    other people’s code.
Developers work with the
IKEA model when using code
     that is not theirs:
Developers work with the
IKEA model when using code
     that is not theirs:

 Open it, mess around, start
reading when you get stuck.
Developers work with the
IKEA model when using code
     that is not theirs:

 Open it, mess around, start
reading when you get stuck.
  Complain when you find a
   channel that answers.
Readers I encountered:
Readers I encountered:

– Give me all the information, I find
  what I need.
Readers I encountered:

– Give me all the information, I find
  what I need.
– Get me a step-by-step instruction
  how to do things
Readers I encountered:

– Give me all the information, I find
  what I need.
– Get me a step-by-step instruction
  how to do things
– I want to click on things and see
  how they work, then read.
Readers I encountered:
Readers I encountered:

– I need something to copy + paste
  and get on with it myself
Readers I encountered:

– I need something to copy + paste
  and get on with it myself
– I don’t get it, can you show me?
Readers I encountered:

– I need something to copy + paste
  and get on with it myself
– I don’t get it, can you show me?
– Doesn’t work for me, I know better
  and this never worked in my
  professional environment.
Catering for them all is tricky.
However, readers are not
Pokemons – you don’t need
    to catch them all.
Start with the basics
Start with the basics

– Why is this a good idea
– Which real-life day to day web
  development problem is solved by it.
– What is the level of this tutorial – what
  do you need to know.
– Show a prominent link to a working
  example – if there is a visual outcome
  use a linked screenshot.
Start with the basics

– Why is this a good idea
– Which real-life day to day web
  development problem is solved by it.
– What is the level of this tutorial – what
  do you need to know.
– Show a prominent link to a working
  example – if there is a visual outcome
  use a linked screenshot.
Start with the basics

– Why is this a good idea
– Which real-life day to day web
  development problem is solved by it.
– What is the level of this tutorial – what
  do you need to know.
– Show a prominent link to a working
  example – if there is a visual outcome
  use a linked screenshot.
Start with the basics

– Why is this a good idea
– Which real-life day to day web
  development problem is solved by it.
– What is the level of this tutorial – what
  do you need to know.
– Show a prominent link to a working
  example – if there is a visual outcome
  use a linked screenshot.
Start with the basics

– Offer links to full documentation
  elsewhere (W3C, MSDN, YDN)
– Offer the download package with code
  examples or image templates upfront.
– Give an estimate as to how long it
  should take to go through this tutorial.
– Say your name, a way to contact you
  and when you wrote this.
Start with the basics

– Offer links to full documentation
  elsewhere (W3C, MSDN, YDN)
– Offer the download package with code
  examples or image templates upfront.
– Give an estimate as to how long it
  should take to go through this tutorial.
– Say your name, a way to contact you
  and when you wrote this.
Start with the basics

– Offer links to full documentation
  elsewhere (W3C, MSDN, YDN)
– Offer the download package with code
  examples or image templates upfront.
– Give an estimate as to how long it
  should take to go through this tutorial.
– Say your name, a way to contact you
  and when you wrote this.
Start with the basics

– Offer links to full documentation
  elsewhere (W3C, MSDN, YDN)
– Offer the download package with code
  examples or image templates upfront.
– Give an estimate as to how long it
  should take to go through this tutorial.
– Say your name, a way to contact you
  and when you wrote this.
Start with the basics

– Offer links to full documentation
  elsewhere (W3C, MSDN, YDN)
– Offer the download package with code
  examples or image templates upfront.
– Give an estimate as to how long it
  should take to go through this tutorial.
– Say your name, a way to contact you
  and when you wrote this.
Offer landmarks
Offer landmarks
– Offer a “quick jump / table of contents”
  feature – this also allows bookmarking
– Cut the tutorial up into logical steps /
  units with useful headings (don’t try to
  be funny)
– Add a link to the state of the code at
  each step – so people can follow the
  changes without needing to copy and
  paste.
Offer landmarks
– Offer a “quick jump / table of contents”
  feature – this also allows bookmarking
– Cut the tutorial up into logical steps /
  units with useful headings (don’t try to
  be funny)
– Add a link to the state of the code at
  each step – so people can follow the
  changes without needing to copy and
  paste.
Offer landmarks
– Offer a “quick jump / table of contents”
  feature – this also allows bookmarking
– Cut the tutorial up into logical steps /
  units with useful headings (don’t try to
  be funny)
– Add a link to the state of the code at
  each step – so people can follow the
  changes without needing to copy and
  paste.
Language
Language

– PBE - Plain Bloody English
– Explain your TLAs
– Explain product names and special
  terms
– Use short sentences.
– Avoid the “I”, instead invite the reader
  with a “then you can do…” or a “Let’s…”
Language

– PBE - Plain Bloody English
– Explain your TLAs
– Explain product names and special
  terms
– Use short sentences.
– Avoid the “I”, instead invite the reader
  with a “then you can do…” or a “Let’s…”
Language

– PBE - Plain Bloody English
– Explain your TLAs
– Explain product names and special
  terms
– Use short sentences.
– Avoid the “I”, instead invite the reader
  with a “then you can do…” or a “Let’s…”
Language

– PBE - Plain Bloody English
– Explain your TLAs
– Explain product names and special
  terms
– Use short sentences.
– Avoid the “I”, instead invite the reader
  with a “then you can do…” or a “Let’s…”
Language

– PBE - Plain Bloody English
– Explain your TLAs
– Explain product names and special
  terms
– Use short sentences.
– Avoid the “I”, instead invite the reader
  with a “then you can do…” or a “Let’s…”
Language

– PBE - Plain Bloody English
– Explain your TLAs
– Explain product names and special
  terms
– Use short sentences.
– Avoid the “I” - instead invite the reader
  with a “then you can do…” or a “Let’s…”
Credibility
Credibility

– Back up your statements with examples.
– Back up your statements with third party
  resources.
– Never hush up errors you made. If
  feedback changes your tutorial, thank
  the commenter and add the changes.
  <del>/<ins>
Credibility

– Back up your statements with examples.
– Back up your statements with third party
  resources.
– Never hush up errors you made. If
  feedback changes your tutorial, thank
  the commenter and add the changes.
  <del>/<ins>
Credibility

– Back up your statements with examples.
– Back up your statements with third party
  resources.
– Never hush up errors you made. If
  feedback changes your tutorial, thank
  the commenter and add the changes.
  <del>/<ins>
Credibility

– Back up your statements with examples.
– Back up your statements with third party
  resources.
– Never hush up errors you made. If
  feedback changes your tutorial, thank
  the commenter and add the changes.
  <del>/<ins>
– Have an editor / reviewer
Leaving them hungry
Leaving them hungry

– Offer extra problems / other application
  ideas at the end and let people try them
  out.
– Hint at more tricks in the same vain or
  link to other tutorials.
– Show high-class solutions using that
  trick (which awesome sites use it)
Leaving them hungry

– Offer extra problems / other application
  ideas at the end and let people try them
  out.
– Hint at more tricks in the same vain or
  link to other tutorials.
– Show high-class solutions using that
  trick (which awesome sites use it)
Leaving them hungry

– Offer extra problems / other application
  ideas at the end and let people try them
  out.
– Hint at more tricks in the same vain or
  link to other tutorials.
– Show high-class solutions using that
  trick (which awesome sites use it)
Traps to avoid!

– Don’t offer the solutions to code
  exercises, people will only copy + paste
  and learn nothing.
– Don’t cut up code into non-executable
  chunks, show the whole script then
  repeat the parts bit-by-bit.
– Stick to one solution per tutorial and
  explain this one well.
Traps to avoid!

– Don’t offer the solutions to code
  exercises, people will only copy + paste
  and learn nothing.
– Don’t cut up code into non-executable
  chunks, show the whole script then
  repeat the parts bit-by-bit.
– Stick to one solution per tutorial and
  explain this one well.
Traps to avoid!

– Don’t offer the solutions to code
  exercises, people will only copy + paste
  and learn nothing.
– Don’t cut up code into non-executable
  chunks, show the whole script then
  repeat the parts bit-by-bit.
– Stick to one solution per tutorial and
  explain this one well.
Traps to avoid!

– Don’t offer the solutions to code
  exercises, people will only copy + paste
  and learn nothing.
– Don’t cut up code into non-executable
  chunks, show the whole script then
  repeat the parts bit-by-bit.
– Stick to one solution per tutorial and
  explain this one well.
Maintenance
Maintenance

– Don’t leave your tutorials to collect
  dust.
– If they become outdated, find a
  better, up-to-date solution and link
  or even redirect to this one.
– We have more than enough
  information graveyards.
Maintenance

– Don’t leave your tutorials to collect
  dust.
– If they become outdated, find a
  better, up-to-date solution and link
  or even redirect to this one.
– We have more than enough
  information graveyards.
Maintenance

– Don’t leave your tutorials to collect
  dust.
– If they become outdated, find a
  better, up-to-date solution and link
  or even redirect to this one.
– We have more than enough
  information graveyards.
What are you in for?

– Last but not least, it is not about
  you!
– You will get positive and negative
  comments targeted at you and not
  the subject.
– Don’t take any of these serious.
– Most of your readers will never
  contact you or take part.
What are you in for?

– Last but not least, it is not about
  you!
– You will get positive and negative
  comments targeted at you and not
  the subject.
– Don’t take any of these serious.
– Most of your readers will never
  contact you or take part.
What are you in for?

– Last but not least, it is not about
  you!
– You will get positive and negative
  comments targeted at you and not
  the subject.
– Don’t take any of these serious.
– Most of your readers will never
  contact you or take part.
What are you in for?

– Last but not least, it is not about
  you!
– You will get positive and negative
  comments targeted at you and not
  the subject.
– Don’t take any of these serious.
– Most of your readers will never
  contact you or take part.
What are you in for?

– Last but not least, it is not about
  you!
– You will get positive and negative
  comments targeted at you and not
  the subject.
– Don’t take any of these serious.
– Most of your readers will never
  contact you or take part.
THANKS!


    http://wait-till-i.com
chris.heilmann@gmail.com

More Related Content

What's hot

Design Thinking Simplified -The Entrepreneur's Toolkit Series
Design Thinking Simplified  -The Entrepreneur's Toolkit SeriesDesign Thinking Simplified  -The Entrepreneur's Toolkit Series
Design Thinking Simplified -The Entrepreneur's Toolkit SeriesDr. Deepika Salwankar
 
Design Thinking - Case Studies
Design Thinking - Case StudiesDesign Thinking - Case Studies
Design Thinking - Case StudiesWith Company
 
Blueprint+: Developing a Tool for Service Design
Blueprint+: Developing a Tool for Service DesignBlueprint+: Developing a Tool for Service Design
Blueprint+: Developing a Tool for Service DesignAndy Polaine
 
SXSW - Diving Deep: Best Practices For Interviewing Users
SXSW - Diving Deep: Best Practices For Interviewing UsersSXSW - Diving Deep: Best Practices For Interviewing Users
SXSW - Diving Deep: Best Practices For Interviewing UsersSteve Portigal
 
Design Thinking 101 by Natalie Nixon of Figure 8 Thinking
Design Thinking 101 by Natalie Nixon of Figure 8 ThinkingDesign Thinking 101 by Natalie Nixon of Figure 8 Thinking
Design Thinking 101 by Natalie Nixon of Figure 8 ThinkingNatalie W. Nixon, PhD
 
[演講簡報] Mopcon - 巧用 UI & UX 工具,提升設計溝通品質(彭其捷)
[演講簡報] Mopcon - 巧用 UI & UX 工具,提升設計溝通品質(彭其捷)[演講簡報] Mopcon - 巧用 UI & UX 工具,提升設計溝通品質(彭其捷)
[演講簡報] Mopcon - 巧用 UI & UX 工具,提升設計溝通品質(彭其捷)彭其捷 Jack
 
Evaluation B1: Progression
Evaluation B1: ProgressionEvaluation B1: Progression
Evaluation B1: ProgressionSophieGibson9
 
Personas Demystified 1.0
Personas Demystified 1.0Personas Demystified 1.0
Personas Demystified 1.0Mo Goltz
 
VTU_Tools of Design Thinking.pdf
VTU_Tools of Design Thinking.pdfVTU_Tools of Design Thinking.pdf
VTU_Tools of Design Thinking.pdfvijimech408
 
Introduction to Information Architecture & Design - 2/14/15
Introduction to Information Architecture & Design - 2/14/15Introduction to Information Architecture & Design - 2/14/15
Introduction to Information Architecture & Design - 2/14/15Robert Stribley
 
Guide to Design Sprint
Guide to Design SprintGuide to Design Sprint
Guide to Design SprintHafizdzaki Mcd
 
Personas and its importance
Personas and its importancePersonas and its importance
Personas and its importanceSankarshan D
 
True Intent: The Best Online Benchmark You've Never Measured
True Intent: The Best Online Benchmark You've Never MeasuredTrue Intent: The Best Online Benchmark You've Never Measured
True Intent: The Best Online Benchmark You've Never MeasuredUXPA International
 
1.6 _ Four Questions and Ten Tools.pdf
1.6 _ Four Questions and Ten Tools.pdf1.6 _ Four Questions and Ten Tools.pdf
1.6 _ Four Questions and Ten Tools.pdfLalitha318185
 
User Interface Design Basic
User Interface Design BasicUser Interface Design Basic
User Interface Design BasicHeru WIjayanto
 
Tools for design thinking - University of Virginia
Tools for design thinking - University of VirginiaTools for design thinking - University of Virginia
Tools for design thinking - University of VirginiaIsabelle Goldfarb
 
UI / UX Design Processes
UI / UX Design ProcessesUI / UX Design Processes
UI / UX Design ProcessesMuhammad Hijazi
 
Personas In Product Design
Personas In Product DesignPersonas In Product Design
Personas In Product DesignLauren Martin
 

What's hot (20)

Design Thinking Simplified -The Entrepreneur's Toolkit Series
Design Thinking Simplified  -The Entrepreneur's Toolkit SeriesDesign Thinking Simplified  -The Entrepreneur's Toolkit Series
Design Thinking Simplified -The Entrepreneur's Toolkit Series
 
Design Thinking - Case Studies
Design Thinking - Case StudiesDesign Thinking - Case Studies
Design Thinking - Case Studies
 
Blueprint+: Developing a Tool for Service Design
Blueprint+: Developing a Tool for Service DesignBlueprint+: Developing a Tool for Service Design
Blueprint+: Developing a Tool for Service Design
 
SXSW - Diving Deep: Best Practices For Interviewing Users
SXSW - Diving Deep: Best Practices For Interviewing UsersSXSW - Diving Deep: Best Practices For Interviewing Users
SXSW - Diving Deep: Best Practices For Interviewing Users
 
Design Thinking 101 by Natalie Nixon of Figure 8 Thinking
Design Thinking 101 by Natalie Nixon of Figure 8 ThinkingDesign Thinking 101 by Natalie Nixon of Figure 8 Thinking
Design Thinking 101 by Natalie Nixon of Figure 8 Thinking
 
UI/UX Fundamentals
UI/UX FundamentalsUI/UX Fundamentals
UI/UX Fundamentals
 
[演講簡報] Mopcon - 巧用 UI & UX 工具,提升設計溝通品質(彭其捷)
[演講簡報] Mopcon - 巧用 UI & UX 工具,提升設計溝通品質(彭其捷)[演講簡報] Mopcon - 巧用 UI & UX 工具,提升設計溝通品質(彭其捷)
[演講簡報] Mopcon - 巧用 UI & UX 工具,提升設計溝通品質(彭其捷)
 
Evaluation B1: Progression
Evaluation B1: ProgressionEvaluation B1: Progression
Evaluation B1: Progression
 
Personas Demystified 1.0
Personas Demystified 1.0Personas Demystified 1.0
Personas Demystified 1.0
 
VTU_Tools of Design Thinking.pdf
VTU_Tools of Design Thinking.pdfVTU_Tools of Design Thinking.pdf
VTU_Tools of Design Thinking.pdf
 
Design Thinking
Design Thinking Design Thinking
Design Thinking
 
Introduction to Information Architecture & Design - 2/14/15
Introduction to Information Architecture & Design - 2/14/15Introduction to Information Architecture & Design - 2/14/15
Introduction to Information Architecture & Design - 2/14/15
 
Guide to Design Sprint
Guide to Design SprintGuide to Design Sprint
Guide to Design Sprint
 
Personas and its importance
Personas and its importancePersonas and its importance
Personas and its importance
 
True Intent: The Best Online Benchmark You've Never Measured
True Intent: The Best Online Benchmark You've Never MeasuredTrue Intent: The Best Online Benchmark You've Never Measured
True Intent: The Best Online Benchmark You've Never Measured
 
1.6 _ Four Questions and Ten Tools.pdf
1.6 _ Four Questions and Ten Tools.pdf1.6 _ Four Questions and Ten Tools.pdf
1.6 _ Four Questions and Ten Tools.pdf
 
User Interface Design Basic
User Interface Design BasicUser Interface Design Basic
User Interface Design Basic
 
Tools for design thinking - University of Virginia
Tools for design thinking - University of VirginiaTools for design thinking - University of Virginia
Tools for design thinking - University of Virginia
 
UI / UX Design Processes
UI / UX Design ProcessesUI / UX Design Processes
UI / UX Design Processes
 
Personas In Product Design
Personas In Product DesignPersonas In Product Design
Personas In Product Design
 

Similar to Writing engaging tutorials

Science-Fair Project - (Template)
Science-Fair Project - (Template)Science-Fair Project - (Template)
Science-Fair Project - (Template)Geogropedia World
 
I Want 2 Do Project Tell Me Wat 2 Do
I Want 2 Do Project Tell Me Wat 2 DoI Want 2 Do Project Tell Me Wat 2 Do
I Want 2 Do Project Tell Me Wat 2 DoFelipe Cerda
 
Salt Rapid Prototyping 030310
Salt Rapid Prototyping 030310Salt Rapid Prototyping 030310
Salt Rapid Prototyping 030310Lisa Meece
 
Intro to Web 2.0 for Educators
Intro to Web 2.0 for EducatorsIntro to Web 2.0 for Educators
Intro to Web 2.0 for EducatorsStephen Best
 
Give a Great Tech Talk
Give a Great Tech TalkGive a Great Tech Talk
Give a Great Tech Talkjberkus
 
How To Use Powerpoint -- A Briefing
How To Use Powerpoint -- A BriefingHow To Use Powerpoint -- A Briefing
How To Use Powerpoint -- A BriefingRohn Jay Miller
 
Business idea jenga hackathon
Business idea jenga hackathonBusiness idea jenga hackathon
Business idea jenga hackathonLoovusait
 
Building reusable components with generics and protocols
Building reusable components with generics and protocolsBuilding reusable components with generics and protocols
Building reusable components with generics and protocolsDonny Wals
 
CMS 210: Introduction to Web Accessibility
CMS 210: Introduction to Web AccessibilityCMS 210: Introduction to Web Accessibility
CMS 210: Introduction to Web AccessibilityMontana State University
 
Building a site for people with big imaginations
Building a site for people with big imaginationsBuilding a site for people with big imaginations
Building a site for people with big imaginationsMark Mansour
 
+100 Prompts to Create Content with ChatGPT
+100 Prompts to Create Content with ChatGPT+100 Prompts to Create Content with ChatGPT
+100 Prompts to Create Content with ChatGPTCarl Remi Beauregard
 
Coaching teams in creative problem solving
Coaching teams in creative problem solvingCoaching teams in creative problem solving
Coaching teams in creative problem solvingFlowa Oy
 
Culture And Aesthetic Revisited
Culture And Aesthetic RevisitedCulture And Aesthetic Revisited
Culture And Aesthetic RevisitedAdam Keys
 
Intuitive images: tips and techniques for creating and evaluating graphics in...
Intuitive images: tips and techniques for creating and evaluating graphics in...Intuitive images: tips and techniques for creating and evaluating graphics in...
Intuitive images: tips and techniques for creating and evaluating graphics in...TCUK
 
Technical Writing For Consultants
Technical Writing For ConsultantsTechnical Writing For Consultants
Technical Writing For Consultantsrlucera
 
Building resuable and customizable Vue components
Building resuable and customizable Vue componentsBuilding resuable and customizable Vue components
Building resuable and customizable Vue componentsFilip Rakowski
 
Hr pts-e-dn-version 2.0
Hr pts-e-dn-version 2.0Hr pts-e-dn-version 2.0
Hr pts-e-dn-version 2.0Paul Robere
 

Similar to Writing engaging tutorials (20)

Science-Fair Project - (Template)
Science-Fair Project - (Template)Science-Fair Project - (Template)
Science-Fair Project - (Template)
 
I Want 2 Do Project Tell Me Wat 2 Do
I Want 2 Do Project Tell Me Wat 2 DoI Want 2 Do Project Tell Me Wat 2 Do
I Want 2 Do Project Tell Me Wat 2 Do
 
Salt Rapid Prototyping 030310
Salt Rapid Prototyping 030310Salt Rapid Prototyping 030310
Salt Rapid Prototyping 030310
 
Why You're A Bad PHP Programmer
Why You're A Bad PHP ProgrammerWhy You're A Bad PHP Programmer
Why You're A Bad PHP Programmer
 
Intro to Web 2.0 for Educators
Intro to Web 2.0 for EducatorsIntro to Web 2.0 for Educators
Intro to Web 2.0 for Educators
 
Give a Great Tech Talk
Give a Great Tech TalkGive a Great Tech Talk
Give a Great Tech Talk
 
How To Use Powerpoint -- A Briefing
How To Use Powerpoint -- A BriefingHow To Use Powerpoint -- A Briefing
How To Use Powerpoint -- A Briefing
 
Business idea jenga hackathon
Business idea jenga hackathonBusiness idea jenga hackathon
Business idea jenga hackathon
 
How Not Php
How Not PhpHow Not Php
How Not Php
 
Building reusable components with generics and protocols
Building reusable components with generics and protocolsBuilding reusable components with generics and protocols
Building reusable components with generics and protocols
 
CMS 210: Introduction to Web Accessibility
CMS 210: Introduction to Web AccessibilityCMS 210: Introduction to Web Accessibility
CMS 210: Introduction to Web Accessibility
 
Building a site for people with big imaginations
Building a site for people with big imaginationsBuilding a site for people with big imaginations
Building a site for people with big imaginations
 
+100 Prompts to Create Content with ChatGPT
+100 Prompts to Create Content with ChatGPT+100 Prompts to Create Content with ChatGPT
+100 Prompts to Create Content with ChatGPT
 
Coaching teams in creative problem solving
Coaching teams in creative problem solvingCoaching teams in creative problem solving
Coaching teams in creative problem solving
 
Culture And Aesthetic Revisited
Culture And Aesthetic RevisitedCulture And Aesthetic Revisited
Culture And Aesthetic Revisited
 
Intuitive images: tips and techniques for creating and evaluating graphics in...
Intuitive images: tips and techniques for creating and evaluating graphics in...Intuitive images: tips and techniques for creating and evaluating graphics in...
Intuitive images: tips and techniques for creating and evaluating graphics in...
 
Rails Conf Talk Slides
Rails Conf Talk SlidesRails Conf Talk Slides
Rails Conf Talk Slides
 
Technical Writing For Consultants
Technical Writing For ConsultantsTechnical Writing For Consultants
Technical Writing For Consultants
 
Building resuable and customizable Vue components
Building resuable and customizable Vue componentsBuilding resuable and customizable Vue components
Building resuable and customizable Vue components
 
Hr pts-e-dn-version 2.0
Hr pts-e-dn-version 2.0Hr pts-e-dn-version 2.0
Hr pts-e-dn-version 2.0
 

More from Christian Heilmann

Develop, Debug, Learn? - Dotjs2019
Develop, Debug, Learn? - Dotjs2019Develop, Debug, Learn? - Dotjs2019
Develop, Debug, Learn? - Dotjs2019Christian Heilmann
 
Taking the "vile" out of privilege
Taking the "vile" out of privilegeTaking the "vile" out of privilege
Taking the "vile" out of privilegeChristian Heilmann
 
Seven ways to be a happier JavaScript developer - NDC Oslo
Seven ways to be a happier JavaScript developer - NDC OsloSeven ways to be a happier JavaScript developer - NDC Oslo
Seven ways to be a happier JavaScript developer - NDC OsloChristian Heilmann
 
Artificial intelligence for humans… #AIDC2018 keynote
Artificial intelligence for humans… #AIDC2018 keynoteArtificial intelligence for humans… #AIDC2018 keynote
Artificial intelligence for humans… #AIDC2018 keynoteChristian Heilmann
 
Killing the golden calf of coding - We are Developers keynote
Killing the golden calf of coding - We are Developers keynoteKilling the golden calf of coding - We are Developers keynote
Killing the golden calf of coding - We are Developers keynoteChristian Heilmann
 
Progressive Web Apps - Techdays Finland
Progressive Web Apps - Techdays FinlandProgressive Web Apps - Techdays Finland
Progressive Web Apps - Techdays FinlandChristian Heilmann
 
Taking the "vile" out of privilege
Taking the "vile" out of privilegeTaking the "vile" out of privilege
Taking the "vile" out of privilegeChristian Heilmann
 
Five ways to be a happier JavaScript developer
Five ways to be a happier JavaScript developerFive ways to be a happier JavaScript developer
Five ways to be a happier JavaScript developerChristian Heilmann
 
Sacrificing the golden calf of "coding"
Sacrificing the golden calf of "coding"Sacrificing the golden calf of "coding"
Sacrificing the golden calf of "coding"Christian Heilmann
 
You learned JavaScript - now what?
You learned JavaScript - now what?You learned JavaScript - now what?
You learned JavaScript - now what?Christian Heilmann
 
Sacrificing the golden calf of "coding"
Sacrificing the golden calf of "coding"Sacrificing the golden calf of "coding"
Sacrificing the golden calf of "coding"Christian Heilmann
 
Progressive Web Apps - Covering the best of both worlds - DevReach
Progressive Web Apps - Covering the best of both worlds - DevReachProgressive Web Apps - Covering the best of both worlds - DevReach
Progressive Web Apps - Covering the best of both worlds - DevReachChristian Heilmann
 
Progressive Web Apps - Covering the best of both worlds
Progressive Web Apps - Covering the best of both worldsProgressive Web Apps - Covering the best of both worlds
Progressive Web Apps - Covering the best of both worldsChristian Heilmann
 
Non-trivial pursuits: Learning machines and forgetful humans
Non-trivial pursuits: Learning machines and forgetful humansNon-trivial pursuits: Learning machines and forgetful humans
Non-trivial pursuits: Learning machines and forgetful humansChristian Heilmann
 
Progressive Web Apps - Bringing the web front and center
Progressive Web Apps - Bringing the web front and center Progressive Web Apps - Bringing the web front and center
Progressive Web Apps - Bringing the web front and center Christian Heilmann
 
CSS vs. JavaScript - Trust vs. Control
CSS vs. JavaScript - Trust vs. ControlCSS vs. JavaScript - Trust vs. Control
CSS vs. JavaScript - Trust vs. ControlChristian Heilmann
 
Leveling up your JavaScipt - DrupalJam 2017
Leveling up your JavaScipt - DrupalJam 2017Leveling up your JavaScipt - DrupalJam 2017
Leveling up your JavaScipt - DrupalJam 2017Christian Heilmann
 
The Soul in The Machine - Developing for Humans (FrankenJS edition)
The Soul in The Machine - Developing for Humans (FrankenJS edition)The Soul in The Machine - Developing for Humans (FrankenJS edition)
The Soul in The Machine - Developing for Humans (FrankenJS edition)Christian Heilmann
 

More from Christian Heilmann (20)

Develop, Debug, Learn? - Dotjs2019
Develop, Debug, Learn? - Dotjs2019Develop, Debug, Learn? - Dotjs2019
Develop, Debug, Learn? - Dotjs2019
 
Hinting at a better web
Hinting at a better webHinting at a better web
Hinting at a better web
 
Taking the "vile" out of privilege
Taking the "vile" out of privilegeTaking the "vile" out of privilege
Taking the "vile" out of privilege
 
Seven ways to be a happier JavaScript developer - NDC Oslo
Seven ways to be a happier JavaScript developer - NDC OsloSeven ways to be a happier JavaScript developer - NDC Oslo
Seven ways to be a happier JavaScript developer - NDC Oslo
 
Artificial intelligence for humans… #AIDC2018 keynote
Artificial intelligence for humans… #AIDC2018 keynoteArtificial intelligence for humans… #AIDC2018 keynote
Artificial intelligence for humans… #AIDC2018 keynote
 
Killing the golden calf of coding - We are Developers keynote
Killing the golden calf of coding - We are Developers keynoteKilling the golden calf of coding - We are Developers keynote
Killing the golden calf of coding - We are Developers keynote
 
Progressive Web Apps - Techdays Finland
Progressive Web Apps - Techdays FinlandProgressive Web Apps - Techdays Finland
Progressive Web Apps - Techdays Finland
 
Taking the "vile" out of privilege
Taking the "vile" out of privilegeTaking the "vile" out of privilege
Taking the "vile" out of privilege
 
Five ways to be a happier JavaScript developer
Five ways to be a happier JavaScript developerFive ways to be a happier JavaScript developer
Five ways to be a happier JavaScript developer
 
Taking the P out of PWA
Taking the P out of PWATaking the P out of PWA
Taking the P out of PWA
 
Sacrificing the golden calf of "coding"
Sacrificing the golden calf of "coding"Sacrificing the golden calf of "coding"
Sacrificing the golden calf of "coding"
 
You learned JavaScript - now what?
You learned JavaScript - now what?You learned JavaScript - now what?
You learned JavaScript - now what?
 
Sacrificing the golden calf of "coding"
Sacrificing the golden calf of "coding"Sacrificing the golden calf of "coding"
Sacrificing the golden calf of "coding"
 
Progressive Web Apps - Covering the best of both worlds - DevReach
Progressive Web Apps - Covering the best of both worlds - DevReachProgressive Web Apps - Covering the best of both worlds - DevReach
Progressive Web Apps - Covering the best of both worlds - DevReach
 
Progressive Web Apps - Covering the best of both worlds
Progressive Web Apps - Covering the best of both worldsProgressive Web Apps - Covering the best of both worlds
Progressive Web Apps - Covering the best of both worlds
 
Non-trivial pursuits: Learning machines and forgetful humans
Non-trivial pursuits: Learning machines and forgetful humansNon-trivial pursuits: Learning machines and forgetful humans
Non-trivial pursuits: Learning machines and forgetful humans
 
Progressive Web Apps - Bringing the web front and center
Progressive Web Apps - Bringing the web front and center Progressive Web Apps - Bringing the web front and center
Progressive Web Apps - Bringing the web front and center
 
CSS vs. JavaScript - Trust vs. Control
CSS vs. JavaScript - Trust vs. ControlCSS vs. JavaScript - Trust vs. Control
CSS vs. JavaScript - Trust vs. Control
 
Leveling up your JavaScipt - DrupalJam 2017
Leveling up your JavaScipt - DrupalJam 2017Leveling up your JavaScipt - DrupalJam 2017
Leveling up your JavaScipt - DrupalJam 2017
 
The Soul in The Machine - Developing for Humans (FrankenJS edition)
The Soul in The Machine - Developing for Humans (FrankenJS edition)The Soul in The Machine - Developing for Humans (FrankenJS edition)
The Soul in The Machine - Developing for Humans (FrankenJS edition)
 

Recently uploaded

Generative AI Use Cases and Applications.pdf
Generative AI Use Cases and Applications.pdfGenerative AI Use Cases and Applications.pdf
Generative AI Use Cases and Applications.pdfalexjohnson7307
 
UiPath manufacturing technology benefits and AI overview
UiPath manufacturing technology benefits and AI overviewUiPath manufacturing technology benefits and AI overview
UiPath manufacturing technology benefits and AI overviewDianaGray10
 
“Iamnobody89757” Understanding the Mysterious of Digital Identity.pdf
“Iamnobody89757” Understanding the Mysterious of Digital Identity.pdf“Iamnobody89757” Understanding the Mysterious of Digital Identity.pdf
“Iamnobody89757” Understanding the Mysterious of Digital Identity.pdfMuhammad Subhan
 
Simplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdf
Simplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdfSimplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdf
Simplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdfFIDO Alliance
 
Design Guidelines for Passkeys 2024.pptx
Design Guidelines for Passkeys 2024.pptxDesign Guidelines for Passkeys 2024.pptx
Design Guidelines for Passkeys 2024.pptxFIDO Alliance
 
ERP Contender Series: Acumatica vs. Sage Intacct
ERP Contender Series: Acumatica vs. Sage IntacctERP Contender Series: Acumatica vs. Sage Intacct
ERP Contender Series: Acumatica vs. Sage IntacctBrainSell Technologies
 
WebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM PerformanceWebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM PerformanceSamy Fodil
 
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...FIDO Alliance
 
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptxHarnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptxFIDO Alliance
 
Design and Development of a Provenance Capture Platform for Data Science
Design and Development of a Provenance Capture Platform for Data ScienceDesign and Development of a Provenance Capture Platform for Data Science
Design and Development of a Provenance Capture Platform for Data SciencePaolo Missier
 
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...panagenda
 
Long journey of Ruby Standard library at RubyKaigi 2024
Long journey of Ruby Standard library at RubyKaigi 2024Long journey of Ruby Standard library at RubyKaigi 2024
Long journey of Ruby Standard library at RubyKaigi 2024Hiroshi SHIBATA
 
Intro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджераIntro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджераMark Opanasiuk
 
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdfHow Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdfFIDO Alliance
 
Event-Driven Architecture Masterclass: Challenges in Stream Processing
Event-Driven Architecture Masterclass: Challenges in Stream ProcessingEvent-Driven Architecture Masterclass: Challenges in Stream Processing
Event-Driven Architecture Masterclass: Challenges in Stream ProcessingScyllaDB
 
Using IESVE for Room Loads Analysis - UK & Ireland
Using IESVE for Room Loads Analysis - UK & IrelandUsing IESVE for Room Loads Analysis - UK & Ireland
Using IESVE for Room Loads Analysis - UK & IrelandIES VE
 
Portal Kombat : extension du réseau de propagande russe
Portal Kombat : extension du réseau de propagande russePortal Kombat : extension du réseau de propagande russe
Portal Kombat : extension du réseau de propagande russe中 央社
 
Event-Driven Architecture Masterclass: Engineering a Robust, High-performance...
Event-Driven Architecture Masterclass: Engineering a Robust, High-performance...Event-Driven Architecture Masterclass: Engineering a Robust, High-performance...
Event-Driven Architecture Masterclass: Engineering a Robust, High-performance...ScyllaDB
 
The Zero-ETL Approach: Enhancing Data Agility and Insight
The Zero-ETL Approach: Enhancing Data Agility and InsightThe Zero-ETL Approach: Enhancing Data Agility and Insight
The Zero-ETL Approach: Enhancing Data Agility and InsightSafe Software
 
Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024Patrick Viafore
 

Recently uploaded (20)

Generative AI Use Cases and Applications.pdf
Generative AI Use Cases and Applications.pdfGenerative AI Use Cases and Applications.pdf
Generative AI Use Cases and Applications.pdf
 
UiPath manufacturing technology benefits and AI overview
UiPath manufacturing technology benefits and AI overviewUiPath manufacturing technology benefits and AI overview
UiPath manufacturing technology benefits and AI overview
 
“Iamnobody89757” Understanding the Mysterious of Digital Identity.pdf
“Iamnobody89757” Understanding the Mysterious of Digital Identity.pdf“Iamnobody89757” Understanding the Mysterious of Digital Identity.pdf
“Iamnobody89757” Understanding the Mysterious of Digital Identity.pdf
 
Simplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdf
Simplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdfSimplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdf
Simplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdf
 
Design Guidelines for Passkeys 2024.pptx
Design Guidelines for Passkeys 2024.pptxDesign Guidelines for Passkeys 2024.pptx
Design Guidelines for Passkeys 2024.pptx
 
ERP Contender Series: Acumatica vs. Sage Intacct
ERP Contender Series: Acumatica vs. Sage IntacctERP Contender Series: Acumatica vs. Sage Intacct
ERP Contender Series: Acumatica vs. Sage Intacct
 
WebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM PerformanceWebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM Performance
 
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
 
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptxHarnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
Harnessing Passkeys in the Battle Against AI-Powered Cyber Threats.pptx
 
Design and Development of a Provenance Capture Platform for Data Science
Design and Development of a Provenance Capture Platform for Data ScienceDesign and Development of a Provenance Capture Platform for Data Science
Design and Development of a Provenance Capture Platform for Data Science
 
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
 
Long journey of Ruby Standard library at RubyKaigi 2024
Long journey of Ruby Standard library at RubyKaigi 2024Long journey of Ruby Standard library at RubyKaigi 2024
Long journey of Ruby Standard library at RubyKaigi 2024
 
Intro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджераIntro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджера
 
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdfHow Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
 
Event-Driven Architecture Masterclass: Challenges in Stream Processing
Event-Driven Architecture Masterclass: Challenges in Stream ProcessingEvent-Driven Architecture Masterclass: Challenges in Stream Processing
Event-Driven Architecture Masterclass: Challenges in Stream Processing
 
Using IESVE for Room Loads Analysis - UK & Ireland
Using IESVE for Room Loads Analysis - UK & IrelandUsing IESVE for Room Loads Analysis - UK & Ireland
Using IESVE for Room Loads Analysis - UK & Ireland
 
Portal Kombat : extension du réseau de propagande russe
Portal Kombat : extension du réseau de propagande russePortal Kombat : extension du réseau de propagande russe
Portal Kombat : extension du réseau de propagande russe
 
Event-Driven Architecture Masterclass: Engineering a Robust, High-performance...
Event-Driven Architecture Masterclass: Engineering a Robust, High-performance...Event-Driven Architecture Masterclass: Engineering a Robust, High-performance...
Event-Driven Architecture Masterclass: Engineering a Robust, High-performance...
 
The Zero-ETL Approach: Enhancing Data Agility and Insight
The Zero-ETL Approach: Enhancing Data Agility and InsightThe Zero-ETL Approach: Enhancing Data Agility and Insight
The Zero-ETL Approach: Enhancing Data Agility and Insight
 
Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024
 

Writing engaging tutorials

  • 1. Writing engaging tutorials Making them come back for more Christian Heilmann Yahoo! Frontend Engineering Summit UK December 2007 http://creativecommons.org/licenses/by-sa/3.0/
  • 2. There is no perfect tutorial.
  • 3. … as there is no “one” audience.
  • 4. One thing to keep in mind is the perceived speed of the internet and the impatience of developers.
  • 5. We are much more patient when it comes to assembling a plumbing unit in our flat than when it comes to using other people’s code.
  • 6. Developers work with the IKEA model when using code that is not theirs:
  • 7. Developers work with the IKEA model when using code that is not theirs: Open it, mess around, start reading when you get stuck.
  • 8. Developers work with the IKEA model when using code that is not theirs: Open it, mess around, start reading when you get stuck. Complain when you find a channel that answers.
  • 10. Readers I encountered: – Give me all the information, I find what I need.
  • 11. Readers I encountered: – Give me all the information, I find what I need. – Get me a step-by-step instruction how to do things
  • 12. Readers I encountered: – Give me all the information, I find what I need. – Get me a step-by-step instruction how to do things – I want to click on things and see how they work, then read.
  • 14. Readers I encountered: – I need something to copy + paste and get on with it myself
  • 15. Readers I encountered: – I need something to copy + paste and get on with it myself – I don’t get it, can you show me?
  • 16. Readers I encountered: – I need something to copy + paste and get on with it myself – I don’t get it, can you show me? – Doesn’t work for me, I know better and this never worked in my professional environment.
  • 17. Catering for them all is tricky.
  • 18. However, readers are not Pokemons – you don’t need to catch them all.
  • 19. Start with the basics
  • 20. Start with the basics – Why is this a good idea – Which real-life day to day web development problem is solved by it. – What is the level of this tutorial – what do you need to know. – Show a prominent link to a working example – if there is a visual outcome use a linked screenshot.
  • 21. Start with the basics – Why is this a good idea – Which real-life day to day web development problem is solved by it. – What is the level of this tutorial – what do you need to know. – Show a prominent link to a working example – if there is a visual outcome use a linked screenshot.
  • 22. Start with the basics – Why is this a good idea – Which real-life day to day web development problem is solved by it. – What is the level of this tutorial – what do you need to know. – Show a prominent link to a working example – if there is a visual outcome use a linked screenshot.
  • 23. Start with the basics – Why is this a good idea – Which real-life day to day web development problem is solved by it. – What is the level of this tutorial – what do you need to know. – Show a prominent link to a working example – if there is a visual outcome use a linked screenshot.
  • 24. Start with the basics – Offer links to full documentation elsewhere (W3C, MSDN, YDN) – Offer the download package with code examples or image templates upfront. – Give an estimate as to how long it should take to go through this tutorial. – Say your name, a way to contact you and when you wrote this.
  • 25. Start with the basics – Offer links to full documentation elsewhere (W3C, MSDN, YDN) – Offer the download package with code examples or image templates upfront. – Give an estimate as to how long it should take to go through this tutorial. – Say your name, a way to contact you and when you wrote this.
  • 26. Start with the basics – Offer links to full documentation elsewhere (W3C, MSDN, YDN) – Offer the download package with code examples or image templates upfront. – Give an estimate as to how long it should take to go through this tutorial. – Say your name, a way to contact you and when you wrote this.
  • 27. Start with the basics – Offer links to full documentation elsewhere (W3C, MSDN, YDN) – Offer the download package with code examples or image templates upfront. – Give an estimate as to how long it should take to go through this tutorial. – Say your name, a way to contact you and when you wrote this.
  • 28. Start with the basics – Offer links to full documentation elsewhere (W3C, MSDN, YDN) – Offer the download package with code examples or image templates upfront. – Give an estimate as to how long it should take to go through this tutorial. – Say your name, a way to contact you and when you wrote this.
  • 30. Offer landmarks – Offer a “quick jump / table of contents” feature – this also allows bookmarking – Cut the tutorial up into logical steps / units with useful headings (don’t try to be funny) – Add a link to the state of the code at each step – so people can follow the changes without needing to copy and paste.
  • 31. Offer landmarks – Offer a “quick jump / table of contents” feature – this also allows bookmarking – Cut the tutorial up into logical steps / units with useful headings (don’t try to be funny) – Add a link to the state of the code at each step – so people can follow the changes without needing to copy and paste.
  • 32. Offer landmarks – Offer a “quick jump / table of contents” feature – this also allows bookmarking – Cut the tutorial up into logical steps / units with useful headings (don’t try to be funny) – Add a link to the state of the code at each step – so people can follow the changes without needing to copy and paste.
  • 34. Language – PBE - Plain Bloody English – Explain your TLAs – Explain product names and special terms – Use short sentences. – Avoid the “I”, instead invite the reader with a “then you can do…” or a “Let’s…”
  • 35. Language – PBE - Plain Bloody English – Explain your TLAs – Explain product names and special terms – Use short sentences. – Avoid the “I”, instead invite the reader with a “then you can do…” or a “Let’s…”
  • 36. Language – PBE - Plain Bloody English – Explain your TLAs – Explain product names and special terms – Use short sentences. – Avoid the “I”, instead invite the reader with a “then you can do…” or a “Let’s…”
  • 37. Language – PBE - Plain Bloody English – Explain your TLAs – Explain product names and special terms – Use short sentences. – Avoid the “I”, instead invite the reader with a “then you can do…” or a “Let’s…”
  • 38. Language – PBE - Plain Bloody English – Explain your TLAs – Explain product names and special terms – Use short sentences. – Avoid the “I”, instead invite the reader with a “then you can do…” or a “Let’s…”
  • 39. Language – PBE - Plain Bloody English – Explain your TLAs – Explain product names and special terms – Use short sentences. – Avoid the “I” - instead invite the reader with a “then you can do…” or a “Let’s…”
  • 41. Credibility – Back up your statements with examples. – Back up your statements with third party resources. – Never hush up errors you made. If feedback changes your tutorial, thank the commenter and add the changes. <del>/<ins>
  • 42. Credibility – Back up your statements with examples. – Back up your statements with third party resources. – Never hush up errors you made. If feedback changes your tutorial, thank the commenter and add the changes. <del>/<ins>
  • 43. Credibility – Back up your statements with examples. – Back up your statements with third party resources. – Never hush up errors you made. If feedback changes your tutorial, thank the commenter and add the changes. <del>/<ins>
  • 44. Credibility – Back up your statements with examples. – Back up your statements with third party resources. – Never hush up errors you made. If feedback changes your tutorial, thank the commenter and add the changes. <del>/<ins> – Have an editor / reviewer
  • 46. Leaving them hungry – Offer extra problems / other application ideas at the end and let people try them out. – Hint at more tricks in the same vain or link to other tutorials. – Show high-class solutions using that trick (which awesome sites use it)
  • 47. Leaving them hungry – Offer extra problems / other application ideas at the end and let people try them out. – Hint at more tricks in the same vain or link to other tutorials. – Show high-class solutions using that trick (which awesome sites use it)
  • 48. Leaving them hungry – Offer extra problems / other application ideas at the end and let people try them out. – Hint at more tricks in the same vain or link to other tutorials. – Show high-class solutions using that trick (which awesome sites use it)
  • 49. Traps to avoid! – Don’t offer the solutions to code exercises, people will only copy + paste and learn nothing. – Don’t cut up code into non-executable chunks, show the whole script then repeat the parts bit-by-bit. – Stick to one solution per tutorial and explain this one well.
  • 50. Traps to avoid! – Don’t offer the solutions to code exercises, people will only copy + paste and learn nothing. – Don’t cut up code into non-executable chunks, show the whole script then repeat the parts bit-by-bit. – Stick to one solution per tutorial and explain this one well.
  • 51. Traps to avoid! – Don’t offer the solutions to code exercises, people will only copy + paste and learn nothing. – Don’t cut up code into non-executable chunks, show the whole script then repeat the parts bit-by-bit. – Stick to one solution per tutorial and explain this one well.
  • 52. Traps to avoid! – Don’t offer the solutions to code exercises, people will only copy + paste and learn nothing. – Don’t cut up code into non-executable chunks, show the whole script then repeat the parts bit-by-bit. – Stick to one solution per tutorial and explain this one well.
  • 54. Maintenance – Don’t leave your tutorials to collect dust. – If they become outdated, find a better, up-to-date solution and link or even redirect to this one. – We have more than enough information graveyards.
  • 55. Maintenance – Don’t leave your tutorials to collect dust. – If they become outdated, find a better, up-to-date solution and link or even redirect to this one. – We have more than enough information graveyards.
  • 56. Maintenance – Don’t leave your tutorials to collect dust. – If they become outdated, find a better, up-to-date solution and link or even redirect to this one. – We have more than enough information graveyards.
  • 57. What are you in for? – Last but not least, it is not about you! – You will get positive and negative comments targeted at you and not the subject. – Don’t take any of these serious. – Most of your readers will never contact you or take part.
  • 58. What are you in for? – Last but not least, it is not about you! – You will get positive and negative comments targeted at you and not the subject. – Don’t take any of these serious. – Most of your readers will never contact you or take part.
  • 59. What are you in for? – Last but not least, it is not about you! – You will get positive and negative comments targeted at you and not the subject. – Don’t take any of these serious. – Most of your readers will never contact you or take part.
  • 60. What are you in for? – Last but not least, it is not about you! – You will get positive and negative comments targeted at you and not the subject. – Don’t take any of these serious. – Most of your readers will never contact you or take part.
  • 61. What are you in for? – Last but not least, it is not about you! – You will get positive and negative comments targeted at you and not the subject. – Don’t take any of these serious. – Most of your readers will never contact you or take part.
  • 62. THANKS! http://wait-till-i.com chris.heilmann@gmail.com