CODE == TEXT

Are you insecure about your technical writing skills as a developer? Don't fret, if you write code (especially Ruby), you are the writer already.

Transcript

1. CODE == TEXT … and developers are writers And(re)y Bar(a)nov, Evil Martians
2. RUBYRUSSIA 2019 progapandist @progapandist 2 evilmartians.com
3. RUBYRUSSIA 2019 progapandist @progapandist 3 evilmartians.com
4. RUBYRUSSIA 2019 progapandist @progapandist 4 evilmartians.com/chronicles
5. RUBYRUSSIA 2019 progapandist @progapandist 2000 - 2002 2003 - 2013 2013-2016 How I got here
6. RUBYRUSSIA 2019 progapandist @progapandist 6 Text file
7. RUBYRUSSIA 2019 progapandist @progapandist 7 Text file
8. RUBYRUSSIA 2019 progapandist @progapandist 8 we work with text files all day &' we make sure our code is readable and contains no errors we version text files we (mostly) don’t like to write in human languages We are developers
9. RUBYRUSSIA 2019 progapandist @progapandist 9 we work with text files all day &' we make sure our text is readable and contains no errors we version text files we (mostly) don’t like to write in computer languages ) We are writers
10. RUBYRUSSIA 2019 progapandist @progapandist 10 But… Why?
11. RUBYRUSSIA 2019 progapandist @progapandist 11 OK, let’s talk pyramids
12. RUBYRUSSIA 2019 progapandist @progapandist 12
13. RUBYRUSSIA 2019 progapandist @progapandist 13 TDD pyramid
14. RUBYRUSSIA 2019 progapandist @progapandist 14 Code Text Linters Spell checkers Unit tests Style, paragraphs System tests Chapters, composition Manual tests, QA Editor-in-chief, your mom
15. RUBYRUSSIA 2019 progapandist @progapandist 15 Journalism Ruby #initialize private methods one-liners #call
16. RUBYRUSSIA 2019 progapandist @progapandist 16 Ruby style Writing style Short lines Short sentences Short methods Short paragraphs Well-chosen names Well-chosen words Idioms (GitHub) Duh, idioms! (Literature)
17. RUBYRUSSIA 2019 progapandist @progapandist 17 Junior developers Junior writers Read code before you write it! Read articles before you write them!
18. RUBYRUSSIA 2019 progapandist @progapandist 18 SOLID Code A class/method should only have a single responsibility…
19. RUBYRUSSIA 2019 progapandist @progapandist 19 SOLID Writing A paragraph/sentence should only have a single responsibility…
20. evl.ms/blog @progapandist progapandist @evilmartians evl.ms/telegram Thank you, and enjoy writing (and reading)! RUBYRUSSIA 2019 20