1 – Who Are You Writing For?<\/a>
2 – Build Structure First<\/a>
3 – Just Write<\/a>
4 – Edit and Review<\/a>
5 – Add Some Visuals<\/a>
6 – Leave Overnight<\/a>
7 – Tell the World<\/a><\/strong><\/p><\/blockquote>\n\n\n\nThis was written originally with the folks on Dev.to<\/a> in mind so references specific tooling used on the platform. If you’d like to get started writing on technical topics Dev.to<\/a> is a great place to start.<\/em><\/p>\n\n\n\n
\n\n\n\n1 – Who Are You Writing For?<\/h2>\n\n\n\n
To get started, determine who it is you are writing for. Having an idea of your audience is just as important as the topic itself. Even if you are writing for ‘future you’ having that in mind will keep you on track.<\/p>\n\n\n\n
- Are you writing for beginners<\/a> or experienced developers? Try and have empathy for your reader before you start writing.<\/li>
- If you are writing for experienced developers what do you expect them to already know?<\/li>
- Consider a series of posts for more complex topics. Your readers will appreciate being able to jump in at any point when they are ready to learn something new.<\/li><\/ul>\n\n\n\n
\n\n\n\n2 – Build Structure First<\/h2>\n\n\n\n
Think about the main points you want to get across before you start writing. Putting this down as a base will save you dwelling on any one point for too long. I like to use six or seven headings for my content, an introduction, conclusion and some links which I add when I’m ready to publish.<\/p>\n\n\n\n
- Create an outline to structure your post. If you like my structure you can find the template in this gist<\/a>.<\/li>
- Think about having several headings, subheadings and maybe bullet points. This not only structures your thoughts but makes it easy for your reader to skim.<\/li><\/ul>\n\n\n\n
\n\n\n\n3 – Just Write<\/h2>\n\n\n\n
With your structure in place, you can fill in the gaps with your tips, tricks, and knowledge. This step is the most rewarding as you get all that great information out of your head and onto the page. Set aside an hour or two to research your topic and write your first draft.<\/p>\n\n\n\n
- Get your ideas into a Google Doc, text editor or straight into the\u00a0Dev.to editor<\/a>.<\/li>
- Try and write in the same way you would speak to a colleague<\/a>. Let the approachable nature you have in real life carry over to your post.<\/li>
- Try to be concise and get the most important talking points down first. You can always add more later.<\/li><\/ul>\n\n\n\n
\n\n\n\n4 – Edit and Review<\/h2>\n\n\n\n
Now that your ideas are on paper it’s time to review and edit. This step is all about refining your thoughts and trimming it down. At this stage, it’s important to note you shouldn’t get too attached to what you have written. If it doesn’t need to be there, take it out.<\/p>\n\n\n\n
- Ask yourself – does it fulfil its purpose? Is it easy to understand?<\/li>
- Avoid vague language that tells your reader nothing. How long is a “long time”? How many do you mean by “several”?<\/li>
- To tackle spelling I like using Grammarly.<\/a> Just remember you shouldn’t rely on it for all your editing. It won’t catch correctly spelt words that are in the wrong place.<\/li><\/ul>\n\n\n\n
\n\n\n\n5 – Add Some Visuals<\/h2>\n\n\n\n
Once you are happy with the general layout and content consider adding some visual elements. This doesn’t have to mean images. You can add code blocks, liquid tags to show relevant posts or even embed tweets. All these extras keep things interesting and save your readers from a wall of text.<\/p>\n\n\n\n
- The\u00a0flavour of markdown<\/a>\u00a0Dev uses supports syntax highlighting in code blocks. This makes code easier to read, and more accessible than an image of code.<\/li>
- Consider creating a flowchart or architecture diagram. This can be done for free in Google Draw and if you’re an AWS user<\/a> you can\u00a0download their icons<\/a>\u00a0too.<\/li>
- Free stock images are available on\u00a0Pexels<\/a>\u00a0for images in your post or as a cover. The best size is 1000 x 420 so keep that in mind as you are cropping. Don’t forget to show your appreciation by crediting the creator!<\/li>
- Canva<\/a>\u00a0is another good option if you are feeling creative and would prefer to build something original.<\/li><\/ul>\n\n\n\n
\n\n\n\n6 – Leave Overnight<\/h2>\n\n\n\n
You’re almost done! Congratulations on getting this far. Now it’s time to sleep on it.<\/p>\n\n\n\n
Having some time away from your post allows you to do one more edit with fresh eyes. You may spot a typo you didn’t see before or decide to rearrange your points so it flows better.<\/p>\n\n\n\n
- Don’t get carried away and go from zero to published in one day.<\/li>
- Read your final draft aloud to test sentence length and remove unnecessary words.<\/li>
- Think about how you would respond if you were reading this post. If you have would have questions, think about answering them for your readers.<\/li><\/ul>\n\n\n\n
\n\n\n\n7 – Tell the World<\/h2>\n\n\n\n
Now that your work is done and you’re ready to publish, consider how you will let the world know about it. This will help get your post out there and build your personal brand.<\/p>\n\n\n\n
- Share your post on your favourite social media networks – Linkedin, Twitter, Reddit, HackerNews or in a Facebook group.<\/li>
- Make use of the tools here on Dev and “Suggest a Tweet”<\/a>. You may be tweeted by the main account or one of the topic-specific accounts<\/a>.<\/li><\/ul>\n\n\n\n
\n\n\n\nThis is the process I go through each time I write. It allows me to collect my thoughts, keep my reader in mind and stay on track.<\/p>\n\n\n\n
I’d love to know the process you go through as you write. Do you have a process or any tips to share?<\/p>\n\n\n\n
\n\n\n\nPhoto by Plush Design Studio<\/a><\/strong> from Pexels<\/a><\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"