DEV Community

Make Your Writing More Approachable for Learners

Brian P. Hogan on January 31, 2020

If you're creating technical content in order to teach others, you might be tempted to use words like "easy", "simple", or "straightforward" becaus...
Collapse
 
georgewl profile image
George WL

This is basically easy and just a obvious and obviously straightforward and simply simple method, I love it.

Edited to remove the crap and it becomes so much nicer and removes the chance of coming across as sarcastic or belittling:

This, I love it.

Collapse
 
fyodorio profile image
Fyodor

Yeah, it always drives me mad when I see titles like ”Easy-peasy authentication with JWT my neighbor 5yo had told me about”. It’s hardly ever aligned with reality.

Collapse
 
jennapederson profile image
Jenna Pederson

This is awesome Brian! Thanks for sharing this.

Collapse
 
aminarria profile image
Amin Arria

Love it! Usually when working with more junior developers I have to constantly remind me to not explain things using those words