Howreadable

 Howreadable

A lightening talk explaining the motivation behind our "howreadable" experiment and encouraging participation.

Please take at https://howreadable.com

1a93f6606abdcf0ec6a850df9e4b830d?s=128

Daniel van Berzon

November 07, 2019
Tweet

Transcript

  1. 3.
  2. 4.
  3. 7.

    Prescriptive Arbitrary grammar rule that prescribes the way people should

    speak "Never end a sentence with a preposition!"
  4. 11.
  5. 12.

    "Never end a sentence with a preposition!" Joshua Poole (1646)

    John Dryden (1672) Prescriptive What is he on about?
  6. 13.

    Descriptive Evidence-based Grammar rule that describes the way people speak

    naturally. "English word order is: Subject - Verb - Object"
  7. 14.

    Penny eats pizza Penny pizza eats Eats penny pizza Eats

    pizza penny Pizza penny eats Pizza eats penny
  8. 15.

    Penny eats pizza Penny pizza eats Eats penny pizza Eats

    pizza penny Pizza penny eats Pizza eats penny
  9. 18.

    Airbnb JavaScript Style Guide: // bad function sayHi(name) { return

    'How are you, ' + name + '?'; } // good function sayHi(name) { return `How are you, ${name}?`; } Template strings give you a readable, concise syntax ... “ ” Often mentions readability
  10. 21.

    Online experiment to find descriptive rules for code readability Measures

    readability of coding constructs Showing code snippets to developers Measuring how easily they read them
  11. 22.

    What do we measure? Can developer predict output of code?

    Time takes them to understand the code
  12. 26.

    Experiment is live Measuring 11 constructs > 500 participants Need

    more participants to get better results Comments Naming Pure functions Abstraction Boolean algebra Ternary operators Chaining methods If statements Inline functions Early return Operator precedence