DEV Community

Cover image for The Best Practices for a Great Developer Experience (DX)

The Best Practices for a Great Developer Experience (DX)

Sam Jarman πŸ‘¨πŸΌβ€πŸ’» on October 12, 2017

What is DX? Developer Experience (DX) is the equivalent to User Experience (UX) when the user of the software or system is a developer. ...
Collapse
Β 
kayis profile image
K β€’

Side-note: The business people are already hijacking DX for digital transformation, so don't be confused if you just read DX somewhere and it doesn't make any sense :D

Collapse
Β 
samjarman profile image
Sam Jarman πŸ‘¨πŸΌβ€πŸ’» β€’

Ha! Good point!

shakes fist at The Business People

Collapse
Β 
letsbsocial1 profile image
Maria Campbell β€’ β€’ Edited

This was a great post Sam. I was publishing an article here today which I had already published to my company website about how to import images into React components, and I used the word directory 99% of the time. However, originally I decided to use the word "folder" instead to shake things up. right before I read your piece I was wondering whether using folder as well would prove confusing. After I read this, I realized that it could be. I write about code a lot and articulate my experiences in articles as well. I always want to make sure that I state things clearly and as simply as possible so that everyone at every level can understand. And besides, just because someone might be very experienced does not mean that they will necessarily follow your explanation. In addition, they might still find a particular topic difficult. I will be taking your advice here to heart for other things. Totally makes sense and extremely helpful. Thanks!

Collapse
Β 
samjarman profile image
Sam Jarman πŸ‘¨πŸΌβ€πŸ’» β€’

Glad I could help! Yes, consistency of terms is important, and try to use the term from the specific domain. I'm not a react dev, but if "directory" is the term most commonly used, go with that!

Collapse
Β 
ben profile image
Ben Halpern β€’

Damn this is a great overview. Sharing with the team. Thanks as always Sam.

Collapse
Β 
samjarman profile image
Sam Jarman πŸ‘¨πŸΌβ€πŸ’» β€’

Very welcome, Ben! I, as always, really appreciate the kind words.

Collapse
Β 
____dave_ profile image
Dave Orleans β€’

Totally agree. What can be done or have you seen done in the open source space? Volunteers, little time and rush can overlook good documentation. At first I thought it was me when going through OS apps and having a difficult time implementing or learning as a newbie. Thanks for this and it needs to be more mainstream reading!

Collapse
Β 
samjarman profile image
Sam Jarman πŸ‘¨πŸΌβ€πŸ’» β€’

Dave, totally understand the pressure on open source docs. I think its worth noting that contribution to open source docs is contribution to open source. It doesn't necessarily have to be code you contribute.

Usually, my first thing with any project (OSS or internal company) are fixes to the ReadMe... there's always something to add.

Collapse
Β 
t4rzsan profile image
Jakob Christensen β€’

Spot on. Especially when it comes to documentation where lots of open source projects are lacking, even several of the large and famous ones.

Collapse
Β 
samjarman profile image
Sam Jarman πŸ‘¨πŸΌβ€πŸ’» β€’

Exactly! You can improve their docs too if they're open source – that'd be a valuable contribution.

Collapse
Β 
maestromac profile image
Mac Siri β€’

These are some great advice. Thank you for sharing!

Collapse
Β 
samjarman profile image
Sam Jarman πŸ‘¨πŸΌβ€πŸ’» β€’

Thank you! I really appreciate the kind words :)