Graphical Explanations

Explanations GRAPHICAL Geoﬀrey Grosenbach VP of Open Source Content @topfunky

SKIM FLIP READ

I don’t think of source code control as code backup.
I think of it as code talk, as communication. – Zed Shaw

Meet Elixir Write concurrent programs with beautiful syntax on the
highly scalable Erlang VM

body {! width: 640px;! margin: 1em auto;! ! font-family: 'ff-tisa-web-pro';!
} pygments SublimeHighlight

••••••• •••••••••••••• •••••••••••••• •••••••••••

WARNING The Internet was not originally designed to do what
we use it for now.

Symbolset / Symbolicons

pancakes ☀ bike rocket squarekey sun

Explanations

Explanatory Tools • Bad/Good • Problem/Solution • Before/After • Good/Better/Best
• Compare/Contrast • Analogy • Timeline

http://jeremypowerscrosscamp.com/

⚠ + Single letter method names Vague, easy to forget,
encourages sloppy code. Real words Self-documenting. Easy for you and other developers to understand and use months later.

BEFORE AFTER http://fstoppers.com/how-‐to-‐photograph-‐real-‐estate-‐architecture-‐and-‐interiors-‐tutorial-‐with-‐mike-‐kelley

<html>! ! ! ! ! ! ! ! ! !
! ! </html> <h1>Never get involved in a land war in Asia.</h1>! ! Beware of the <b>rodents</b> of <i>unusual</i> size.! ! Never get involved in a land war in Asia. ! Beware of the rodents of unusual size.

Good /img/mountain.jpg Better /products/gloves ⚙ ⚙ ⚙

Timeline

#AS14 TEACHING IS DIFFICULT LEARNING IS DIFFICULT BECAUSE

4PM Design and UX of Documentation

TEACH WITH US! geoﬀ[email protected]

Graphical Explanations

Graphical Explanations

Geoffrey Grosenbach

More Decks by Geoffrey Grosenbach

Other Decks in Education

Featured

Transcript

Explanations GRAPHICAL Geoﬀrey Grosenbach VP of Open Source Content @topfunky

SKIM FLIP READ

Type

I don’t think of source code control as code backup.

Meet Elixir Write concurrent programs with beautiful syntax on the

body {! width: 640px;! margin: 1em auto;! ! font-family: 'ff-tisa-web-pro';!

••••••• •••••••••••••• •••••••••••••• •••••••••••

WARNING The Internet was not originally designed to do what

Icons

Symbolset / Symbolicons

pancakes ☀ bike rocket squarekey sun

#AS14

Explanations

Explanatory Tools • Bad/Good • Problem/Solution • Before/After • Good/Better/Best

http://jeremypowerscrosscamp.com/

⚠ + Single letter method names Vague, easy to forget,

BEFORE AFTER http://fstoppers.com/how-‐to-‐photograph-‐real-‐estate-‐architecture-‐and-‐interiors-‐tutorial-‐with-‐mike-‐kelley

<html>! ! ! ! ! ! ! ! ! !

Good /img/mountain.jpg Better /products/gloves ⚙ ⚙ ⚙

Timeline

#AS14 TEACHING IS DIFFICULT LEARNING IS DIFFICULT BECAUSE

4PM Design and UX of Documentation

TEACH WITH US! geoﬀ[email protected]