Best Practices for Writing on DEV: Topics

Mai 17, às 16:01


5 min de leitura


0 leituras

Hey devs! Time for another installment in our Best Practices for Writing on DEV series. Today I'll share some guidelines for choosing and framing your topic. Topics We created DEV because we wanted to...
Best Practices for Writing on DEV: Topics

Hey devs! Time for another installment in our Best Practices for Writing on DEV series. Today I'll share some guidelines for choosing and framing your topic.


We created DEV because we wanted to build a community around the things we all do and love: software development, computer engineering, life in the tech industry, and dreaming big about the possibilities of tech and open source. We welcome posts about a wide variety of topics that intersect these core subjects.

We love tutorials, discussion prompts, conference recaps, and personal stories. We love reading about what you’re building, and we love when you host your docs updates and changelogs on DEV! We even love a good listicle every once in a while, as long as it’s packed with value and personal insight.

Are you allowed to write about other things on DEV? Totally! We have plenty of great articles about writing, lived experiences that intersect the industry, and one pretty good one about Moose Facts. But you’ll have the best chance at growing your readership and having meaningful discussions on DEV if you’re mostly writing about dev and tech industry stuff, most of the time.


There are two main ways to interact with tags on DEV: as an author and as a reader.

Making the most of tags as an author

When you write a post on DEV, you can add up to four tags to help readers find your content. Some tags on DEV are active communities, such as #CodeNewbie and #BrazilianDevs. We also have supported and moderated tags for programming languages, frameworks and tools, different types of discussions, and more.

Before tagging your content, take a look at each tag page to make sure you’re picking the right vibe—that gives you the best chance of connecting with your intended readers!

Making the most of tags as a reader

You can find posts on the topics you’re interested in using tags. Follow the tags you want to prioritize in your feed and set your tag weights to fine-tune your experience.

We’re always looking for more DEV Community members to volunteer to become tag moderators! Tag mods are essential to keeping our tags organized, on-topic, and engaging.

Learn more about becoming a tag moderator:

Bring a unique perspective

No matter what topic you’re writing about, you’re most likely to reach readers and make an impact if you bring a unique perspective to the topic.

For example, let’s say you want to write a tutorial explaining how to use promises and async/await in Javascript. There are already a lot of articles on DEV that explain this concept in depth (like this favorite of ours by @lydiahallie!), so if you write a basic explainer, you’re not likely to get a lot of readers’ attention.

You might consider a different approach: bringing in your own experience and perspective. Here are some prompts to help guide you:

  • How did you learn this concept? If you learned by experimenting and making mistakes, share the story with your readers.
  • How have you seen the concept implemented in real-life applications? Consider writing about interesting, edge case, or so-strange-it-just-might-work approaches you’ve seen in the wild.
  • How might you approach this topic differently based on a unique use case?
  • Are there any extended metaphors or analogies you could use to explain the concept in a fresh way?

Technical writing is a great tool for learning concepts yourself, and blogs are great proof of your learning journey. If you’re interested in building community, growing your audience, and improving your technical writing skills, consider the above prompts next time you approach writing a basic tutorial!

Provide a clear takeaway

Readers visit posts on DEV for a variety of reasons: to learn something new, to get informed on industry trends, to check the docs for their favorite OS project, to share stories and build community, or even to quickly copy-paste some code and never look back.

In all of these cases, though, readers are looking for one thing in common: a clear takeaway.

Once you’ve identified the one, two, or three main takeaways from your post, consider stating them clearly in both the introduction and the conclusion. This is a common public speaking technique: “Tell them what you’re going to tell them, tell them, and then tell them what you told them.”

If your post has more than three main takeaways, consider breaking it down into multiple posts and creating a series!


When it comes to writing on DEV, make the most of your topic of choice by using tags, bringing a unique perspective, and providing a clear takeaway!

Of course, you are welcome to write whatever and however you want on DEV, as long as it adheres to our Code of Conduct — these guidelines are meant to help you make the most of the DEV platform by improving your content writing skills and connecting with your readers.

That's all for now! Stay tuned for another installment in this series all about self-promotional posts on DEV.

Continue lendo


Founding Developer of WordPress: I Just Paid for Twitter Blue - Here's Why | HackerNoon
Start WritingNotificationssee moreFounding Developer of WordPress: I Just Paid for Twitter Blue - Here's Why [email protected] 26th 2023 New Story by @techtweeter Too Long; Didn't Read3. I believe in...

Mai 26, às 21:45


Google lança API para exibir extensões na barra lateral do Chrome
O Google está lançando uma nova API chamada Chrome Side Panel, que permite que extensões do Chrome exibam interfaces na barra lateral do navegador. A novidade possibilita que as extensões criem “experiências...

Mai 26, às 21:24

IT Forum

OLX Brasil anuncia novo CEO: Olivier Aizac - IT Forum
Olivier Aizac (esquerda) e Andries Oudshoorn. Foto: Kaique Talles, Divulgação A OLX Brasil anunciou nessa sexta (26) a nomeação do executivo francês Olivier Aizac como Chief Executive Officer (CEO). A...

Mai 26, às 20:20


Concordex Launches Testnet Of Its Concordium-Built Institutional Focused DEX | HackerNoon
Too Long; Didn't ReadConcordex, the first dedicated decentralized exchange (DEX) built on the Concordium blockchain, has officially launched its testnet. The project raised $1.7 million in seed funding from...

Mai 26, às 20:09


Lançamentos do Amazon Prime Gaming em junho de 2023: SteamWorld Dig 2 e mais!
Índice Todos os lançamentos do Amazon Prime Gaming em junho de 2023Jogos gratuitos do Prime Gaming de junho de 2023Mutation NationSengoku 2Over TopSoccer BrawlSteamWorld Dig 2The Super SpyTop...

Mai 26, às 18:34


Implante cerebral da Neuralink já pode ser testado em humanos
Índice O histórico da tentativa da empresa de Musk de testar implante cerebralComo a Neuralink pesquisa a interação entre cérebro e máquina?O que as pesquisas em cérebros humanos na Europa conseguiram?Como...

Mai 26, às 18:33


THE SIX | HackerNoon
Too Long; Didn't ReadONE evening, at twilight, they were assembled in a group, all six of them. Uncle Paul was reading in a large book. He always reads to rest himself from his labors, finding that after work...

Mai 26, às 18:23


The Story-book of Science by Jean-Henri Fabre - Table of Links | HackerNoon
The Story-book of Science by Jean-Henri Fabre - Table of Links [email protected] Long; Didn't ReadThe Story-book of Science by Jean-Henri Fabre is part of the HackerNoon Books Series. Read this book...

Mai 26, às 18:22

IT Forum

Apple, Tesla e Amazon lideram ranking do BCG das mais inovadoras do mundo - IT Forum
Imagem: Shutterstock As empresas de tecnologia mantêm a liderança no ranking das 50 empresas mais inovadoras do mundo realizado pelo Boston Consulting Group (BCG). A Apple ocupa o primeiro lugar da lista...

Mai 26, às 18:15


Kingston lança pendrive com senha para maior segurança
Índice Linha IronKey para dados sensíveis Pendrive Locker +50 Vault Privacy 50 Ironkey Privacy 200Kingston ajuda usuários em nova compra A Kingston Brasil convidou jornalistas e influencers a comparecem ao...

Mai 26, às 16:56