Ce diaporama a bien été signalé.
Nous utilisons votre profil LinkedIn et vos données d’activité pour vous proposer des publicités personnalisées et pertinentes. Vous pouvez changer vos préférences de publicités à tout moment.

The Seven Righteous Fights

274 vues

Publié le

SpringOne Platform 2016
Speaker: Heidi Waterhouse; Documentation Mercenary

There are seven fights that I have over and over again, whenever I start at a company. I'm here to convince you that it's valuable for everyone to have these things in mind from the inception of a project. Having these fights early prevents you from doing the software equivalent of poking chocolate chips into an already-baked cookie Details Usually we think of compound interest as what adds magically to our retirement or makes our student loans last forever. But there is also a compound interest of technical debt, where a project is made harder and more expensive because of early "cost-saving" choices. I think it's empowering for developers and other people involved in the inception of a project to have tools for making the project better long-term. The seven things I think should be considered very early in development are:

-Localization. Are you ever planning on selling this to someone in another country?
-Security. Don't be the organization that has to pay someone for disaster PR. Building in security early saves you a bunch of time and user churn later.
-Extensibility. What makes you so sure this API will always be internal?
-Documentation. People do not buy software solely based on Powerpoints. You need public docs. The docs have to be more useful than Stack Overflow.
-Affordance. UI is not a word. The microtext matters.
-Acceptance. Have you shown this to any actual humans who are like the users?
-Accessibility. We all use computers different ways. Does your software allow that?

I expect this talk will be relevant to both senior people working on leading project teams, and empowering for juniors who don't have a structure for critiquing usability problems. I want people to leave with an understand of how small changes in the initial trajectory of a project can lead to greatly improved outcomes.

Publié dans : Technologie
  • Soyez le premier à commenter

  • Soyez le premier à aimer ceci

The Seven Righteous Fights

  1. 1. The Seven Righteous Fights You Should Be Fighting
  2. 2. @wiredferret#7fights Heidi Waterhouse SpringOne Platform 2016 #7fights h.waterhouse@gmail.com @wiredferret
  3. 3. @wiredferret#7fights Definition of a Technical Writer: A master of assembling technical clues into a narrative whole
  4. 4. @wiredferret #7fights This truck is stuck in the mud
  5. 5. #7fights @wiredferret
  6. 6. @wiredferret#7fights Example
  7. 7. @wiredferret #7fights Tower of translation Babel
  8. 8. @wiredferret#7fights Plus two weeks 5 days
  9. 9. @wiredferret #7fights Fingers crossed
  10. 10. @wiredferret#7fights You cannot fix it later
  11. 11. @wiredferret#7fights
  12. 12. @wiredferret#7fights The Seven Righteous Fights 1. Localization 2. Security 3. Extensibility 4. Documentation 5. Affordance 6. Acceptance 7. Accessibility
  13. 13. #7fights @wiredferret Localization Localisation
  14. 14. Localization Don't hard code interface elements No words in logos or images Bake in extended character support
  15. 15. #7fights @wiredferret Security
  16. 16. @wiredferret #7fights The most successful hackers actually look like auditors
  17. 17. @wiredferret #7fights
  18. 18. @wiredferret#7fights Security is neither cheap nor easy, But it beats the alternative
  19. 19. @wiredferret#7fights Encryption
  20. 20. @wiredferret#7fights
  21. 21. @wiredferret#7fights
  22. 22. @wiredferret#7fights Stop saying that word!
  23. 23. #7fights @wiredferret Extensibility
  24. 24. @wiredferret#7fights
  25. 25. @wiredferret#7fights
  26. 26. #7fights @wiredferret Documentation
  27. 27. @wiredferret#7fights Documentation is not state secrets Documentation is subtle self promotion
  28. 28. User Documentation Cupcake ipsum dolor sit amet icing. Lemon drops soufflé gummies danish dragée pastry chupa chups brownie. Cheesecake liquorice cake.
  29. 29. @wiredferret #7fights Developer onboarding
  30. 30. @wiredferret #7fights Production scripts and build sequence
  31. 31. @wiredferret#7fights Secretive build engineers are bad build engineers
  32. 32. @wiredferret#7fights
  33. 33. #7fights @wiredferret Affordance
  34. 34. @wiredferret#7fights
  35. 35. @wiredferret #7fights Some people have more privileges
  36. 36. @wiredferret #7fights Homunculus of sensation
  37. 37. #7fights @wiredferret Acceptance
  38. 38. @wiredferret #7fights Not all Legos have the same job
  39. 39. @wiredferret#7fights Explain nothing Shhhhhh
  40. 40. @wiredferret#7fights If you can't hire an expert, become a student.
  41. 41. #7fights @wiredferret Accessibility
  42. 42. @wiredferret#7fights
  43. 43. @wiredferret#7fights
  44. 44. @wiredferret#7fights 8% of men are colorblind
  45. 45. @wiredferret #7fights Screen reader links Click here. Link. Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link.Click here. Link
  46. 46. @wiredferret#7fights
  47. 47. @wiredferret#7fights TAB Temporarily Able-Bodied
  48. 48. #7fights @wiredferret Now what?
  49. 49. @wiredferret#7fights Tactics Do what you can Start where you are. Use what you have. Do what you can - Arthur Ashe
  50. 50. #7fights @wiredferret Tactic 1 Write a coding style guide and follow it.
  51. 51. #7fights @wiredferret Tactic 2 Pair programming for best practices.
  52. 52. #7fights @wiredferret Tactic 3 Host brown bag lunches.
  53. 53. #7fights @wiredferret Tactic 4 Ask questions.
  54. 54. #7fights @wiredferret Tactic 5 Add tests for accessibility and usability.
  55. 55. #7fights @wiredferret Tactic 6 Learn to write ROI documents.
  56. 56. #7fights @wiredferret Tactic 7 Cultivate inclusion, diversity, and representation.
  57. 57. @wiredferret #7fights Money is the root of all business decisions
  58. 58. The Seven Righteous Fights 1. Localization - Make users comfy 2. Security - Make users safer 3. Extensibility - Make code usable 4. Documentation - Disaster-proof 5. Affordance - Nudge good behavior 6. Acceptance - Test with users 7. Accessibility - Include people
  59. 59. @wiredferret#7fights tl;rt Don't build in compounding technical debt that you could trivially avoid.
  60. 60. @wiredferret#7fights Be productively lazy.
  61. 61. @wiredferret#7fights Heidi Waterhouse SpringOne Platform 2016 #7fights h.waterhouse@gmail.com @wiredferret
  62. 62. @wiredferret Credits Copyright ceridwen and licensed for reuse under this Creative Commons Licence By Dori (Own work) [Public domain], via Wikimedia Commons By Bill Bertram (Own work) [CC BY-SA 2.5 (http://creativecommons.org/licenses/by-sa/2.5)], via Wikimedia Commons https://www.flickr.com/photos/dvortygirl/ https://www.flickr.com/photos/nez/ By Jonathan Joseph Bondhus (Own work) [CC BY-SA 3.0 (http://creativecommons.org/licenses/by-sa/3.0)], via Wikimedia Commons By User:Bryan Derksen (Own work) [Public domain], via Wikimedia Commons Joshua Reynolds [Public domain], via Wikimedia Commons By Ken Teegardin from Boulder, Boulder (Piggy Bank On Pennies) [CC BY-SA 2.0 (http://creativecommons.org/licenses/by-sa/2.0)], via Wikimedia Commons By Evan-Amos (Own work) [CC BY-SA 3.0 (http://creativecommons.org/licenses/by-sa/3.0)], via Wikimedia Commons By Lasart75 (Own work) [GFDL (http://www.gnu.org/copyleft/fdl.html) or CC BY-SA 4.0-3.0-2.5-2.0-1.0 (http://creativecommons.org/licenses/by-sa/4.0-3.0-2.5-2.0-1. 0)], via Wikimedia Commons https://www.flickr.com/photos/31333486@N00/ By Jojhnjoy (Own work, based on the work of Anders) [Public domain], via Wikimedia Commons By Jericho [CC BY 3.0 (http://creativecommons.org/licenses/by/3.0)], via Wikimedia Commons

×