presentation

# D'.a1[accord]
## A survey of interesting .a2[*agreements*] in Software Engineering

.right[
```
2019.12.02 
Elliott Edwards 
https://github.com/el2iot2 
https://twitter.com/el2iot2
```
]
---
# I am a .a1[Xennial]
<blockquote class="twitter-tweet" data-lang="en"><a href="https://twitter.com/hashtag/mypeople?src=hash&ref_src=twsrc%5Etfw">#mypeople</a> The Oregon Trail Generation: Life before and after mainstream tech <a href="https://t.co/bOI1mtzvzR">https://t.co/bOI1mtzvzR</a> via <a href="https://twitter.com/mashable?ref_src=twsrc%5Etfw">@mashable</a>— Brian Hacker (@hackdive) <a href="https://twitter.com/hackdive/status/964558199734063106?ref_src=twsrc%5Etfw">February 16, 2018</a></blockquote>
---
# I am a .a1[Consultant]
<blockquote class="twitter-tweet" data-lang="en"><a href="https://twitter.com/hashtag/redshirt?src=hash&ref_src=twsrc%5Etfw">#redshirt</a> <a href="https://twitter.com/hashtag/Starfleet?src=hash&ref_src=twsrc%5Etfw">#Starfleet</a> <a href="https://twitter.com/hashtag/StarTrek?src=hash&ref_src=twsrc%5Etfw">#StarTrek</a> <a href="https://twitter.com/StarTrek?ref_src=twsrc%5Etfw">@StarTrek</a> <a href="https://t.co/92ZGenCgHK">pic.twitter.com/92ZGenCgHK</a>— B.K. on the AIR 📻 (@bkontheair) <a href="https://twitter.com/bkontheair/status/960862327649243142?ref_src=twsrc%5Etfw">February 6, 2018</a></blockquote>
---
# I am a .a1[Telecommuter]
<blockquote class="twitter-tweet" data-lang="en">When you work from home <a href="https://t.co/QLalk2mOCY">pic.twitter.com/QLalk2mOCY</a>— Darth Vader (@DepressedDarth) <a href="https://twitter.com/DepressedDarth/status/935622856628690944?ref_src=twsrc%5Etfw">November 28, 2017</a></blockquote>
---
# I am a .a1[Unicyclist]
<blockquote class="twitter-tweet" data-lang="en">Parenting is a delicate balance <a href="https://t.co/fxMyECWoPR">pic.twitter.com/fxMyECWoPR</a>— Elliott B. Edwards (@el2iot2) <a href="https://twitter.com/el2iot2/status/969224287491039232?ref_src=twsrc%5Etfw">March 1, 2018</a></blockquote>
---
# I am an .a1[Artist]
<blockquote class="twitter-tweet" data-conversation="none" data-lang="en">Last hours of the day are for pen(cil) and paper: <a href="https://t.co/1nyvI41BZF">pic.twitter.com/1nyvI41BZF</a>— Elliott B. Edwards (@el2iot2) <a href="https://twitter.com/el2iot2/status/954149644015058944?ref_src=twsrc%5Etfw">January 19, 2018</a></blockquote>
---
# I .a1[love] software engineering
<blockquote class="twitter-tweet" data-lang="en">Roses are red, violets are blue. now I have two. I fixed one threading problem,— Chris Adamson (@invalidname) <a href="https://twitter.com/invalidname/status/963788391233064960?ref_src=twsrc%5Etfw">February 14, 2018</a></blockquote>
---
# .a1[Warning:] Subjective takes ahead
<blockquote class="twitter-tweet" data-lang="en">I can't think of a single instance where anecdotal evidence was inaccurate.— Merlin Mann (@hotdogsladies) <a href="https://twitter.com/hotdogsladies/status/545270814925258754?ref_src=twsrc%5Etfw">December 17, 2014</a></blockquote>
---
# RE: The .a1[holiest] of wars
<blockquote class="twitter-tweet" data-lang="en">Emacs. <a href="https://t.co/7yBGAbGClp">pic.twitter.com/7yBGAbGClp</a>— Rich Siegel (@siegel) <a href="https://twitter.com/siegel/status/1198446250133217281?ref_src=twsrc%5Etfw">November 24, 2019</a></blockquote>
Perhaps: Use the right tool/stack/pattern/language/paradigm for the job. 
---
# Software is .a1[multi-faceted]
.pull-left[
.left[
- Perf
- InfoSec
- Architecture/Patterns
- Database/SQL/NoSQL
- UI/UX
- QA
- Infrastructure/Ops
- Academic
]
]
.pull-right[
.left[
- Algorithms
- Graphics
- Games
- AI
- Distributed Computing
- Automation
- Training/Teaching
- Technical Writing
]
]
---
# It takes a .a1[village]
<blockquote class="twitter-tweet" data-lang="en">Full stack devs: Those front end devs really need to skill up in other areas. Also full stack devs: <a href="https://t.co/TG6PfzMgJN">pic.twitter.com/TG6PfzMgJN</a>— Mark Dalgleish 🎄 (@markdalgleish) <a href="https://twitter.com/markdalgleish/status/1196520160800034816?ref_src=twsrc%5Etfw">November 18, 2019</a></blockquote>
Specialization is a thing...
---
# Further proof
<blockquote class="twitter-tweet" data-lang="en">UX Is My Passion 🥰 <a href="https://t.co/kRA9OqkOgU">pic.twitter.com/kRA9OqkOgU</a>— Caree Youngman (@careecodes) <a href="https://twitter.com/careecodes/status/1194937279355207680?ref_src=twsrc%5Etfw">November 14, 2019</a></blockquote>
---
# Problem: There is a ton to know/master/do in the field.
.pull-right[
.left[
- X Breadth
- X Depth
- X Quantity
]
]

Software engineering is a team sport! 
---
# So lets utilize homogenous nodes and distribute the work!
Example: Unsorted meatspace phone number lookup
---
# .a1[Worst] Case!
<blockquote class="twitter-tweet" data-lang="en">"What one programmer can do in one month, two programmers can do in two months." - Fred Brooks— Programming Wisdom (@CodeWisdom) <a href="https://twitter.com/CodeWisdom/status/926540261148315648?ref_src=twsrc%5Etfw">November 3, 2017</a></blockquote>
---
# How do we do better?
Our ability to parallelize demands that we have agreements and fluid/suitable distributions of responsibilities.
---
# Some helpful agreements with the customer
## What even are we doing? (Requirements)
<blockquote class="twitter-tweet">Walks in...⁣ Barber: Say no more...sit ⁣ 😂 <a href="https://t.co/VCXGRU10WQ">pic.twitter.com/VCXGRU10WQ</a>— WS (@wesleysnipes) <a href="https://twitter.com/wesleysnipes/status/1095370797554626561?ref_src=twsrc%5Etfw">February 12, 2019</a></blockquote> The customer is always right! (Agreement is built in)😃✨
---
# .a1[My Answer:] The napkin sketch (customer)
<blockquote class="twitter-tweet" data-lang="en">I like using simple tools and <a href="https://twitter.com/balsamiq?ref_src=twsrc%5Etfw">@balsamiq</a> is one of my faves. I've used it for years to make quick "napkin note" sketches of UI concepts. E.g., sketch of a 2nd iteration "power meter" concept for a gamified compulsory education course. <a href="https://twitter.com/hashtag/gamification?src=hash&ref_src=twsrc%5Etfw">#gamification</a> <a href="https://twitter.com/hashtag/uidesign?src=hash&ref_src=twsrc%5Etfw">#uidesign</a> <a href="https://twitter.com/hashtag/elearning?src=hash&ref_src=twsrc%5Etfw">#elearning</a> <a href="https://t.co/2OVfona64O">pic.twitter.com/2OVfona64O</a>— Edw. (@edwardcossette) <a href="https://twitter.com/edwardcossette/status/1034938002441691141?ref_src=twsrc%5Etfw">August 29, 2018</a></blockquote>
---
# .a1[My Answer:] Power of the prototype (customer/colleagues)
---
# RE: Scope creep (customer)
<blockquote class="twitter-tweet" data-lang="en">Project Scope <a href="https://t.co/TNAjsL70KQ">https://t.co/TNAjsL70KQ</a> <a href="https://t.co/uuMc2xzG6d">pic.twitter.com/uuMc2xzG6d</a>— CommitStrip (@CommitStrip) <a href="https://twitter.com/CommitStrip/status/910934632933273606?ref_src=twsrc%5Etfw">September 21, 2017</a></blockquote>
---
# RE: Keeping receipts (customer/colleagues)
Make sure your agreements are captured, CC'd to decision makers and preserved for posterity.
---
# RE: How even do we agree on the unknowable?
<blockquote class="twitter-tweet" data-lang="en">The 5 Laws of Software Estimates - <a href="https://t.co/rdZrPpQvn7">https://t.co/rdZrPpQvn7</a> <a href="https://twitter.com/hashtag/agile?src=hash&ref_src=twsrc%5Etfw">#agile</a> <a href="https://twitter.com/hashtag/code?src=hash&ref_src=twsrc%5Etfw">#code</a> <a href="https://twitter.com/hashtag/noestimates?src=hash&ref_src=twsrc%5Etfw">#noestimates</a> <a href="https://t.co/aU5cNOK8X0">pic.twitter.com/aU5cNOK8X0</a>— Steve Smith (@ardalis) <a href="https://twitter.com/ardalis/status/968533232638623747?ref_src=twsrc%5Etfw">February 27, 2018</a></blockquote>
.a1[My Answer:] MVP and break down features into user stories
---
# Some helpful agreements with leadership
## How do we balance committed risk with ownership?
## .a1[My Answer:]
<blockquote class="twitter-tweet" data-lang="en">contribution vs commitment: why I always prefer to have pigs in my <a href="https://twitter.com/hashtag/Agile?src=hash&ref_src=twsrc%5Etfw">#Agile</a> projects <a href="https://twitter.com/hashtag/notaJoke?src=hash&ref_src=twsrc%5Etfw">#notaJoke</a> <a href="https://twitter.com/hashtag/pigsRule?src=hash&ref_src=twsrc%5Etfw">#pigsRule</a> <a href="https://twitter.com/hashtag/pigsAreMyFriends?src=hash&ref_src=twsrc%5Etfw">#pigsAreMyFriends</a> <a href="https://t.co/7QS7ul7iyj">https://t.co/7QS7ul7iyj</a> <a href="https://t.co/yS07pVBZJm">pic.twitter.com/yS07pVBZJm</a>— Farid Mheir (@fmheir) <a href="https://twitter.com/fmheir/status/948238478302687232?ref_src=twsrc%5Etfw">January 2, 2018</a></blockquote>
---
# Some helpful agreements with colleagues
## How do we distribute the work?
## .a1[My Answer:] Invoke Agile Methodology
KanBan, Backlogs, Buglists, Sprints, Grooming, Retrospectives?
---
# Some helpful agreements
## How do we funnel the results back together?
# .a1[My Answer:] Continually do the difficult
<blockquote class="twitter-tweet" data-lang="en">Our new software consultancy produces what we call "raw code", guaranteed NOT to have passed through CI or any kind of onerous "testing". The result is a palpably richer and more authentic software experience— qntm (@qntm) <a href="https://twitter.com/qntm/status/949070111083778050?ref_src=twsrc%5Etfw">January 5, 2018</a></blockquote>
takeaway: do it early, often, and then automatically 
---
# RE: Control your versions
<blockquote class="twitter-tweet" data-lang="en">Hahaha, the real VCS <a href="https://t.co/1U5OEgZkNI">pic.twitter.com/1U5OEgZkNI</a>— Malik Al Ichsan (@malikalichsan) <a href="https://twitter.com/malikalichsan/status/957065362150801410?ref_src=twsrc%5Etfw">January 27, 2018</a></blockquote>
takeaway: you need a safe, identifiable snapshot of your project
---
# RE: Prove it works
<blockquote class="twitter-tweet" data-lang="en">If you liked it then you should have put a regression test on it.— jessie (finder of bug rabbit holes) frazelle (@jessfraz) <a href="https://twitter.com/jessfraz/status/943467824533725184?ref_src=twsrc%5Etfw">December 20, 2017</a></blockquote>
<blockquote class="twitter-tweet" data-lang="en">Universal corollary: if it *is* tested, then it's broken in a way you haven't tested yet.— Paul Vick (@panopticoncntrl) <a href="https://twitter.com/panopticoncntrl/status/955949189199884289?ref_src=twsrc%5Etfw">January 23, 2018</a></blockquote>
takeaway: Get it out of your brain into a system you trust
---
# RE: Test armor
<blockquote class="twitter-tweet" data-lang="en">Think of testing like armour. The more of it you wear the harder it is to hurt you but the harder it is to fight too <a href="http://t.co/6JMyGvGuzl">http://t.co/6JMyGvGuzl</a>— Peter Nixey (@peternixey) <a href="https://twitter.com/peternixey/status/458597921211293696?ref_src=twsrc%5Etfw">April 22, 2014</a></blockquote>
---
# RE: L0 (Unit tests)
<blockquote class="twitter-tweet" data-lang="en">This can never be null, right? I ask because Unit Test Code Coverage with a target of 100% is, frankly, ridiculous. Unit tests can test most use cases, but unit tests can't be expected to test every crazy edge case, right? I mean, come on. Is that even realistic? <a href="https://t.co/qU7Q8lkCRU">pic.twitter.com/qU7Q8lkCRU</a>— Jerry™ 🖖 (@jerrynixon) <a href="https://twitter.com/jerrynixon/status/1196483241386995712?ref_src=twsrc%5Etfw">November 18, 2019</a></blockquote>
---
# RE: L1
Know what a test costs
<blockquote class="twitter-tweet" data-lang="en">[on my death bed, struggling to speak] me: if..your..unit..test..makes..a..network..call..it's..not..a..unit..test.. [dies]— Rebecca Slatkin (@RebeccaSlatkin) <a href="https://twitter.com/RebeccaSlatkin/status/852627030092939274?ref_src=twsrc%5Etfw">April 13, 2017</a></blockquote>
takeaway: optimize tests for fast, cheap failure (L0, L1, L2, etc.)
---
# RE: L2
<blockquote class="twitter-tweet" data-lang="en">2 unit tests. 0 integration tests. <a href="https://t.co/f5zfYYRSs0">pic.twitter.com/f5zfYYRSs0</a>— Ben Halpern 🦁 (@bendhalpern) <a href="https://twitter.com/bendhalpern/status/1193141566174613504?ref_src=twsrc%5Etfw">November 9, 2019</a></blockquote>
---
# RE: It works on my machine!
Versioning and Continuous Deployment
<blockquote class="twitter-tweet" data-lang="en">tfw your error message is a wall of red text <a href="https://t.co/pTLbZqBlQZ">pic.twitter.com/pTLbZqBlQZ</a>— Changelog (@changelog) <a href="https://twitter.com/changelog/status/956263286131101696?ref_src=twsrc%5Etfw">January 24, 2018</a></blockquote>
---
# RE: Continual Funding
Start simple and iterate. Maintain revenue.
<blockquote class="twitter-tweet" data-lang="en">Using webpack for my "hello world" app <a href="https://t.co/MmnXTl0ebw">pic.twitter.com/MmnXTl0ebw</a>— Tomasz Łakomy ⚛ (@tlakomy) <a href="https://twitter.com/tlakomy/status/965864291500019712?ref_src=twsrc%5Etfw">February 20, 2018</a></blockquote>
takeaway: counter YAGNI with "yet"
---
# Our end of the bargain
## .a1[Bitwise] Authority
<blockquote class="twitter-tweet" data-lang="en">Amazon doing their taxes <a href="https://t.co/1AxdTDEb0z">pic.twitter.com/1AxdTDEb0z</a>— Nick Turner (@NicksTurners) <a href="https://twitter.com/NicksTurners/status/1201374251522985984?ref_src=twsrc%5Etfw">December 2, 2019</a></blockquote>
# Our end of the bargain
## Like .a1[Life] Depends on it
<blockquote class="twitter-tweet" data-lang="en">tech company arrogance at its finest. Dexcom provides (a very expensive) continuous glucose readings to people with T1 diabetes and their families is about to reach a 24hr outage and 0 communication from Dexcom about the issue. <a href="https://t.co/MLwwHdhIqX">pic.twitter.com/MLwwHdhIqX</a>— Rebecca Slatkin (@RebeccaSlatkin) <a href="https://twitter.com/RebeccaSlatkin/status/1200980487445106690?ref_src=twsrc%5Etfw">December 1, 2019</a></blockquote>
---
# Some helpful agreements with yourself
## Find personal balance
<blockquote class="twitter-tweet" data-lang="en">man I had no idea you could buy this. I’ve just been using drugs and alcohol <a href="https://t.co/RziVhnvoY3">pic.twitter.com/RziVhnvoY3</a>— Jennaclaire (@jennaaclaire) <a href="https://twitter.com/jennaaclaire/status/963095999517462529?ref_src=twsrc%5Etfw">February 12, 2018</a></blockquote>
takeaway: It is easy for thought workers to get disconnected. have a plan for body/mind/spirit.
---
# Cultivate "soft" skills
<blockquote class="twitter-tweet" data-lang="en">Wife: "Hold hands when crossing the street." *2 year old grabs own hands* "OK Mommy." Me: "Oh you're going to be so good at programming."— Patrick McKenzie (@patio11) <a href="https://twitter.com/patio11/status/912083773814038528?ref_src=twsrc%5Etfw">September 24, 2017</a></blockquote>
takeaway: DoRY, Allow for context, Mentoring is scaling, Diversity matters 
---
# Offer your expertise
<blockquote class="twitter-tweet" data-lang="en">Hardware hacking goes mainstream?! Local supermarket stocks the Raspberry Pi magazines in the cooking section 🤣 <a href="https://t.co/hEST32RKbL">pic.twitter.com/hEST32RKbL</a>— Changelog (@changelog) <a href="https://twitter.com/changelog/status/966352571265937408?ref_src=twsrc%5Etfw">February 21, 2018</a></blockquote>
takeaway: be an advocate, volunteer
---
# Questions? 
<blockquote class="twitter-tweet" data-lang="en">"Theory is when you know something, but it doesn’t work. Practice is when something works, but you don’t know why. Programmers combine theory and practice: Nothing works and they don’t know why." - Unknown— Programming Wisdom (@CodeWisdom) <a href="https://twitter.com/CodeWisdom/status/934067585301340160?ref_src=twsrc%5Etfw">November 24, 2017</a></blockquote>