top of page
  • Writer's pictureYuri Santana

The ultimate guide to content creation for DevRels | Part 2

In our previous encounter, we discussed what is a DevRel, their types and what they actually do. Now, let’s dive deeper into DevRel and talk about how to create good and engaging content.

We see content all around us, but what is the importance? How can you start creating content? Where? How to improve your content?

Content is such a broad term, it basically means getting an idea and creating visual or written content to present it to the world. The better the content you generate, the more likely users will come back and engage with your community and with each other. On the business side of things, it will help you increase engagement, and clients are more likely to continue investing in your product.

The most common type of content we see out there is technical writing. It's more common than we think! We see it with manuals, instructions on how to take medicine and more.

But what exactly is technical writing?

Technical writing

Technical writing is designed to make difficult concepts as easy as possible for readers. Every time you read a user guide, tutorial, manual, case study, etc, those are common examples of technical writing in action.

Technical writing is a core element within any community, especially when you're advocating for a product.

Documentation is the first direct contact you have with developers and users interested in learning about and using a certain product.

It is designed to explain specialized information to those who are not familiar with it and to help those who are looking to deepen their knowledge.

This raises a question:

Does technical writing always involve diving deep into technical content or do we need to separate our audiences?

Sometimes we just want to share content with our community without technical intent. Is that possible?

Developers vs Users

When creating content, which audience should you focus on?

Depending on the type of audience that you wish to target, you will have to take a different creative style to meet the particular needs of each group. We can identify two main audiences: developers and users.


Developers play an active role when consuming content or reading documentation. Having clear guidelines will make them want to contribute and help with the product, ultimately helping improve the code, documentation, and community.

They usually focus more on:

  • API (application programming interface) documentation: which usually defines how applications communicate with each other using requests and responses.

  • Read Me’s: Work as a general description of the product usually with the source code.

  • System Documentation: Help describe the product, technical design, software requirements and more.

  • Release notes: Where they learn about the product launch, features or errors they’ve worked on or information on the latest version of the product.

But it is not unusual for developers to be users and vice versa.


They can play an active or passive role when consuming content. They want to use and understand the product to the best of their abilities. Some ways to target users are to write easy-to-follow guides, and tutorials and guide them to external sources when you need to expand on certain topics.

Users tend to focus more on:

  • How to guide: Help the user reach a goal. The whole purpose is to help the user complete a task.

  • Tutorials: Leave the user with knowledge of a concept or process they didn’t have before.

  • Explanations: Work as a way to shine light on more specific topics they might not know about.

  • Reference documentation: They are made to share with the user more technical descriptions and concepts about the product.

It is important to keep in mind that it is possible to keep both audiences balanced whenever you're creating content. But keep in mind, in some cases both audiences need to be addressed in different ways throughout the content creation process.

User-focused documents should have less technical terminology than when we are talking to developers, always taking into account their background, experience and the different types of content that the two audiences focus on.

How to start creating content

Here's the layout of the content creation process you'll be following most of the time. Keep in mind you don't need to strictly follow one step after the other. There’ll come a time when you start with the investigation, get the idea, generate the content and then identify your audience, check for mistakes and ultimately post it.

The general steps are:

  • Ideate on a topic - what challenges do you want to help your audience with? Make sure that is stated from the get-go as it will help you shape your next steps around it.

  • Investigate - do your research on the subject. Include your personal expertise, but make sure you cross-check other resources on similar subjects. Or perhaps understand what unique angle you can bring to this subject?

  • Create an outline - it will help your storytelling. If you’re not following the structure, it’s most likely your readers/viewers won’t be able to follow it along with you.

  • Identify your audience - remember the challenge you identified? Make sure this is tailored to a specific audience you’re catering to. Use this as a guide to shape not only the content itself but also the best style and format to deliver it.

  • Create the content - start creating your draft, and find teammates or peers to bounce ideas off and/or share your draft for a peer review. Another pair of eyes can be extremely helpful for any content creation efforts!

  • Check for errors - even if you’re the only DevRel in your organization, you can use different tools for fact-checking or grammar errors to make your content spotless. Some of the tools I use are Grammarly or you can also use some other free online grammar checkers.

  • Publish - once you’re ready to go live, publish your work and make sure to also let others know about it. Reach out to your network on social media and the online communities you’re part of. People are likely to cheer for you and also can provide feedback that will help you improve.

  • Repeat! That’s a no-brainer but is often left off the list. In the meantime, you will gather a network, community, and audience around you, who will be excited to see your new content out, so don’t forget to keep them engaged. A more tactical approach and regularity will also help you acquire new audiences along the way.

You should and are encouraged to find what process or steps work for you and make you a productive content creator.

Where to start creating content

It’s quite easy to get trapped in the latest social media apps, but before you start posting content, for a company or your personal brand, you need to know where your users are the most active or where you want to start building a community.

  • Where are your users more active: You want your content to be consumed by your target audience. Start by identifying which social media platforms they are more active on, which communities they frequent and what type of content is their preferred whether that is visual, written or audio.

  • Where do you want to start a community: We often see communities being moved from one platform to another. One way to prevent this major decision is to take a step back and identify where your target audience has the least amount of resistance when joining your community, and which platform will make it easier for them to reach out to the team or share their feedback accurately.

Remember that you want to effectively remove any pain points that will make users not join your community or consume your content, so by placing yourself in your users’ perspective, you help prevent some major pain points that are preventing your community from growing in both members and engagement. Common mistakes

Now that we have a clear idea of the basic steps towards creating content, let's dig deeper into some of the most common mistakes you can avoid that will help you be an effective content creator.

  • Assuming that the person consuming the content has the same technical knowledge as the one creating it: This limits the number of users and developers that will interact with your content. That's why it's important to know your audience. You should always generate your content based on the different levels of prior education your readers will have, not the ones you possess.

  • Not explaining acronyms: You should always break down the meaning of the acronyms you use in text before actively using them in your content, in parentheses. This is very related to the previous point. Do not assume that the person consuming your content has the same technical knowledge as you.

  • The use of the passive voice: By utilizing the passive voice when creating content, you are at risk of generating less clarity and ambiguity in your sentences. However, this can be addressed by using an active voice, which urges the reader to take action and understand the content they are consuming more confidently.

  • Skipping minor steps you think are given: By skipping minor steps that the content creator believes to be a given, the person consuming the content will be lost and won't know what to do. This is particularly detrimental when the goal is for the user to complete a task or understand a concept.

Upgrade your content skills

We've gone over some of the most common mistakes to avoid when creating content. Now what makes the content good? What are some things we should be actively adding to our content?

  • Write in simple terms: Depending on your content strategy and keeping in mind your target audience, technical terms can sometimes bring you closer to your users but, most of the time, there is no need to use extremely technical terms when creating content, especially for the public. Think of a way to present your content that is easy for readers to understand, whether or not they have previous experience with the product.

  • Having a style guide: It can help you create a consistent voice and image within the community, the person consuming the content will respond better to the same form and styling of content, terminology and images. It is not necessary to create one, there are many guides on the internet.

  • Being open and encouraging community feedback: This will help you know which content to improve, which guides work, and which ones are confusing. Remember that ultimately you're creating content for the community, so it is best to know from the source what is working for them and what is not.

  • Tracking changes: Having version control will help you track content changes, especially when working with documentation. In case a new feature is removed due to user feedback, you can go back to the old documentation.

  • Inclusiveness and accessibility:** The internet should be welcoming to everyone. Try to avoid idioms to help the international audience understand your content better, think about people who use screen readers, make sure you have good contrast in the design, and if you are going to use screenshots, make sure they are accompanied by alt-text.

Ultimately, you should think about the users who find your content online. Is it accessible? Is it easy to follow? Can they easily find what they are looking for?

  • Adaptability and Consistency: You need to be able to adapt and grow within the community, do check-ins and see how you can improve. It's a must for a content creator, and this is not possible without being consistent in your craft.

And remember,

It may take time, but there's nothing that gets worse due to practising.

A good and sustainable content strategy takes a lot of trial and error behind the scenes. It's about figuring out what works for you and your goals but also what resonates with the community. Do not be afraid to reiterate some content you've published in the past with new ideas or in a completely new media format, it's all about practice. So practice on, my friend.


bottom of page