DEV Community

Cover image for 20+ Lessons I've Learned Writing on DEV for 4 Years

20+ Lessons I've Learned Writing on DEV for 4 Years

Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ on June 29, 2021

Table of Contents 1. First, get started 2. Do not Bury the Lede ⚑️ 3. Brainstorm on Paper πŸ“ 4. Talk it Through With a Friend πŸ—£ 5. Learn Markd...
Collapse
brandonwallace profile image
brandon_wallace

Nice article. You should also have an introduction to introduce what you will discuss in the article and a conclusion at the end to summarize everything.

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Good point, I always struggle with conclusions :)

Collapse
brandonwallace profile image
brandon_wallace

Me too brother.

Collapse
josefine profile image
Josefine Schfr

Thanks so much for this, I found the tips & all the additional resources super helpful! One thing I learned while writing and I try to improve on is writing inclusively. You never know who reads your article and what their background is - and I think it's important that nobody feel belittled or excluded.

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author • Edited

Thanks for your kind words.

Agree, I try to remember that we are all different and avoid at all costs title like 5 reasons why EVERY PROGRAMMER should have a BLOG! because it's so wrong to be prescritiptive like this:

I dislike not the content but the title, which deny that we all have different lives.

You can be a developer, mother of two small twins, therefore have no time for blogging outside of your job, therefore your title is false.

Collapse
motivatedman profile image
motivatedman

I use to recommend people use blogging but your opnion is really appreciable. It's true that we can't get time for everything in a short day of life.

Thread Thread
motivatedman profile image
motivatedman

And hope you won't mind it, that a stranger commented on your posts. I am new to these platforms, and I am afraid if people like strangers comments or not.

Thread Thread
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Hello, you are very welcome to comment! My hope when I write an article is to have meaningful conversations with people like you.

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Thanks a lot for your insights @yechielk @pjijin @john_papa @vtrpldn @helenanders26 !

Collapse
petermortensen profile image
Peter Mortensen

For "4. Talk it Through With a Friend":

How exactly is that done? Do you summarise it (the friend is unprepared)? Read it aloud as is (the friend is unprepared)? Does the friend get it in advance in writing and then you talk about it? Or something else?

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Good question. I don't use the draft article, I try to summarize it, and I try to make it interesting enough to keep my friend's attention

Collapse
petermortensen profile image
Peter Mortensen

For 3. ("Brainstorm on paper"):

If it is relatively simple text only, I prefer it on the computer (in a simple text editor, not a word processor where you are distracted by formatting).

But I often use a mind map on paper to generate and exhaust thoughts about a subject, including blog posts.

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Mind maps are also a good thing to have in your toolbox. I use paper when I feel stuck on my computer. If I don't, I don't use it.

Collapse
fpsvogel profile image
Felipe Vogel

How did you make your table of contents into a dropdown list? Great tips!

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

It's yet another liquid tag: collapsible then endcollapsible.

Collapse
fpsvogel profile image
Felipe Vogel

Oh, I missed that in DEV's Liquid instructions. Thanks so much!

Collapse
tkuenneth profile image
Thomas KΓΌnneth

Excellent tips, thanks a lot for sharing.

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Thanks Thomas

Collapse
firangizg profile image
Firangiz Ganbarli

Very useful post, thank you!

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Looking forward to read your articles :)

Collapse
miguelmj profile image
MiguelMJ

Very valid points!

Collapse
margo_hdb profile image
Margo McCabe

You make some really interesting points! Very helpful. πŸ‘

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Glad it helped you Margo!

Collapse
wanderingsoul profile image
Jameel Ur Rahman

Nicely written article. Thank you for the helpful tips!

Collapse
kathybowing profile image
Kathy Bowing

Awesome, thank you :-)

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Thanks Kathy :)

Collapse
graciegregory profile image
Gracie Gregory (she/her)

Great post, Jean-Michel. Thank you so much for being part of this community! We're so happy you're here.

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Thankj you so much Gracie, that gives me the motivation to keep going.

Collapse
mccurcio profile image
Matt Curcio

Good ideas,
Thank you

Collapse
empreendedoras7 profile image
Empreendedoras

Good article.

Collapse
alecbsherman profile image
Alec

Great post - thanks for all the advice!

Collapse
capscode profile image
capscode

very helpful article..
definitely its gona help every writers in any of the platform

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

Thank Rahul :)

Collapse
petermortensen profile image
Peter Mortensen • Edited

For "9. Use tags" (cultural faux pas):

Yes, coffee and beer is far better than chlorinated water.

Collapse
petermortensen profile image
Peter Mortensen

For "7. Be Liquid":

It is not clear what "liquid" is or refers to. Perhaps add some link for context?

Collapse
jmfayard profile image
Jean-Michel Fayard πŸ‡«πŸ‡·πŸ‡©πŸ‡ͺπŸ‡¬πŸ‡§πŸ‡ͺπŸ‡ΈπŸ‡¨πŸ‡΄ Author

It was a reference to liquid tags, DEV.to addition to standard markdown