Baking a great DX

Transcript

1. Baking a great DX 1 Chefs’ Tips for Developers Alvaro Navarro - 9 May 2023
3. 3 Photo by Tierra Mallorca on Unsplash
6. Senior Developer Advocate DX team Alvaro Navarro @alnacle @SpotifyPlatform
7. 7 What is DX?
8. The overall experience a developer has when creating software, including the ease of use of tools and the satisfaction of the end result. A crucial aspect of software development that can impact - • Productivity • Creativity • Job Satisfaction What is DX?
9. 9 External DX
10. 10 Internal DX
11. 11 External DX
12. The Developer Journey Discover Evaluate Learn Build Scale
13. Discover Evaluate Learn Build Scale Onboarding The Developer Journey
14. • What is this? • Can it solve my problem? • Is it credible? Discover Evaluate Learn Build Scale Discovery
15. Discover Evaluate Learn Build Scale
16. Discover Evaluate Learn Build Scale
17. • Does it look easy to use? Discover Evaluate Learn Build Scale Evaluation
18. Discover Evaluate Learn Build Scale
19. Discover Evaluate Learn Build Scale
20. • Does it look easy to use? • Are there any red flags? Discover Evaluate Learn Build Scale Evaluation
21. Discover Evaluate Learn Build Scale • Why are there frequently asked questions that are not answered in your documentation? • Could this be a potential symptom that your docs are not accurate? • Would a quick-start guide be better? What about FAQs?
22. Discover Learn Build Scale Evaluate • Are the docs pleasant to use? Learning
23. Discover Learn Build Scale Evaluate
24. Discover Learn Build Scale Evaluate • Are the docs pleasant to use? • Are they lead on a journey or left fumbling? Learning
25. Discover Learn Build Scale Evaluate
26. Discover Learn Build Scale Evaluate Let's talk about documentation…
27. Discover Learn Build Scale Evaluate Hands up if reading good documentation makes you happy. A question for the audience:
28. Discover Learn Build Scale Evaluate Keep your hands up if you enjoy writing documentation for your projects. A question for the audience:
29. Creating good documentation is not easy Exercise: How to prepare a cup of tea? 8 people, 8 different tutorials! Discover Learn Build Scale Evaluate
30. Clear instructions are vital! Discover Learn Build Scale Evaluate
31. Information architecture (IA) Organizing, structuring and labeling content in an effective and sustainable way Discover Learn Build Scale Evaluate
32. Discover Learn Build Scale Evaluate
33. • Understand your audience Discover Learn Build Scale Evaluate Some Advice
34. • Understand your audience • Getting started guide is key Discover Learn Build Scale Evaluate Some Advice
35. Discover Learn Build Scale Evaluate
36. Discover Learn Build Scale Evaluate
37. Time to first Hello World (TTFHW) The measure of how quickly a programmer can get a simple "hello world" program up and running on a new platform or with a new programming language or framework. Discover Learn Build Scale Evaluate
38. Discover Learn Build Scale Evaluate
39. • Understand your audience • Getting started guide is key • Code examples everywhere Discover Learn Build Scale Evaluate More advice
40. Discover Learn Build Scale Evaluate
41. • Understand your audience • Getting started guide is key • Code examples everywhere • Provide tools Discover Learn Build Scale Evaluate More advice
42. Discover Learn Build Scale Evaluate
43. Discover Learn Build Scale Evaluate Building • Is it pleasant to use the product? • Can developers get support easily? • How are issues/bugs handled?
44. Discover Learn Build Scale Evaluate
45. Discover Learn Build Scale Evaluate
46. Discover Learn Build Scale Evaluate Scaling • Can I do more? • Can I make feature requests? • Can I give product feedback? Scale
47. Discover Learn Build Scale Evaluate Scale
48. Discover Learn Build Scale Evaluate Feedback loops Gather Feedback Analyse Feedback Act on Feedback External Developers Prioritise Share feedback Follow up Engineering Team DevRel
49. Discover Learn Build Scale Evaluate Scaling • Can I do more? • Can I make feature requests? • Can I give product feedback? • How can I contribute?
50. Discover Learn Build Scale Evaluate
51. 51 Internal DX?
52. How was your onboarding at your current job?
53. Get everybody engaged in the process Create a catalog of potential resources Establish guidelines QA & Publish Feedback & Support
56. 56 What's next?
57. User Testing Plan Test Debrief Feedback Plan Test Debrief Feedback
58. 58 Proprietary & Confidential Hackathons • Learning by observation • Live feedback
59. 59 Conclusions
60. 60 • Slower adoption • Increased support burden • Siloed Knowledge Bad Developer Experience
61. 61 • Faster adoption • Greater innovation • Less support requirement Good Developer Experience
62. Thank you for listening! Don't forget to rate my talk! :) @alnacle @SpotifyPlatform developer.spotify.com