Best Practices to Write a Technical Blog
Here’s a summary to understand the Why(s), How(s) and What(s) of writing a technical blog.
WHAT To Write?
Writers are obviously at their most natural when they write in first person. Writing is an intimate transaction between two people, conducted on paper, and it will go to the extent that it retains its humanity ~ William Zinsser

Ask Yourself:
→ The Topics that you’ve a good eye for detail of.
→ Know your audience.
→ Know the purpose of your writing.
→ The Topics for which you’ve a pile of supporting aids (visual / text).

WHY To Write?
Explaining things to others is the best way to learn.

→ By writing what you’ve built, you steepen your curve of gaining understanding and deriving insights through it.
→ You may develop a discussion with other developers, which can be fruitful for the betterment of you, as a developer.
→ It’s the authentic view of presenting your own thoughts, in your very own words and nobody can stop you from writing those!
→ The joy you may get my educating others and sharing your knowledge is unparalleled.
HOW To Write?
→ Write persuasively and eloquently. Don’t just write to reproduce your document but present it in a rhetorical fashion that it engages the user.

→ Use analogies, pictures, gifs and code snapshots throughout your article. Keep it picturesque and user-friendly.
→ Be precise, concise and clear in your approach. Let your article be neither too lengthy nor too short of words.
→ Follow a task-based approach. Let your passage segments and paragraphs appear to emanate synchronicity. Use a step-by-step proposition.
→ End with a conclusion, which sums up the information you’ve presented, or invites questions on the blog. Don’t leave the reader hanging.

Balance is the key.
→ Create Lists using dashes _ or asterisk *.
→ Use Block quotes and Pull Quotes wherever necessary.
Follow the “Tips & Tricks for Medium Writers” — https://blog.medium.com/tips-and-tricks-for-medium-writers-1d79498101c3
Relevant Tools To be Used Before Publishing The Article:
- Avoid Plagiarism ~
You can copy/paste or drop in your files here:
Small SEO Tools: https://smallseotools.com/plagiarism-checker/
Grammarly Plagiarism Checker: https://www.grammarly.com/plagiarism-checker
2. Be Grammatically Correct ~
Grammarly: https://www.grammarly.com/
Reverso Speller: http://www.reverso.net/spell-checker/english-spelling-grammar/
3. It’s recommended, that you keep your written words in the range of greater than 1000 and less than 2500.
(Highly Recommended)
If you find, visual aids to be invigorating, relinquishing and helpful : Please do watch!
How to write technical blog posts — talk by Quincy Larson

