Search for a command to run...
I am a passionate web3 technical writer who is curious about the web3 space.
A person with a deep understanding of web3 content marketing. I create educational, informative, and engaging web3 content.
I love writing on anything web3💕💕
Thank you Siraj.
x402 is a new payment standard that enables micro payments on the web by leveraging blockchain technology. It leverages the existing 402 Payment Required status code to require payment before serving a response and uses crypto-native payments for spe...
The so called AI slop all over the internet is getting less sloppy. NBC News We're living through an extraordinary moment in history. The rapid evolution of generative AI has unleashed an unprecedented creative boom. These tools have democratized co...
In these last few years, layer two blockchains (L2) have become central to Ethereum's scaling efforts. L2s are fast, cheap, and inherit Ethereum's strong security guarantees. Ethereum serves as the settlement layer, and L2s serve as the execution lay...
A blockchain is a peer-to-peer (P2P) network of nodes that maintains a shared ledger. Every node communicates with other nodes in the network using specialized P2P protocols to verify blocks, transactions, store state, etc. When you’re building an ap...
Tokens represent money-like assets, utility (such as governance or access), rewards and points, game items, tickets, and more. Most tokens on Solana follow the SPL token standard or Token-2022 with extensions, which define how tokens are created, tra...
You might have the impression that writers are born. But no, they are made!
Writing is a skill you can learn, sharpen, and master through consistent practice over time. All it takes is good resources to learn and to write and read what other writers have written constantly.
Lisa See says, "reading a thousand books will make your words flow like a river".
Are you a lover of emerging technologies, someone who likes to explain things in a way that even a 6-year-old baby can understand? Or are you a developer who loves to share ideas and teach people via written content? Then technical writing is for you. So, let's get started!
A technical writer is a person who writes company documents such as user manuals, reference guides, business plans, legal disclaimers, operating procedure guides, white papers, and specialized product descriptions.
Many people often think that only a person who writes code in an article is a technical writer, and that kind of belief is not accurate. A technical writer is a person who breaks down complex topics or concepts or writes a tutorial guide in any field to make it understandable for readers or users.
A technical writer aims to help readers fully understand a highly complex procedure or topic. To accomplish this, technical writers must be well-versed in the subject matter they are about to write on.
A technical writer, for example, can write on ZKEVM, Solidity, Angular.JS, or any other technical topic to make it understandable to readers.
Technical writing means communicating or conveying one's ideas, views, instructions, and suggestions more logically, technically, and professionally.
According to Grammar, technical writing means the author is writing about a specific subject that requires direction, teaching, or explanation.
This writing style differs significantly from others, and examples include creative writing, academic writing, and business writing.
For example, as a Google technical writer, you might provide documentation on how users can embed YouTube videos. If you're a Twitter technical writer, you could develop documentation explaining how people can build a Twitter profile.
Nevertheless, all technical writers have everyday job duties.
Almost all current global enterprises demand technical documentation. Thus, creating such content has become a job title in and of itself.
All levels of the corporate and commercial hierarchy require someone to translate complex information into easily understood content for the end user. That is the job description for a technical content writer.
In this age, technical writers are indispensable.
The skills mentioned below are necessary to be an excellent technical writer.
1. Having a good command of the English language.
Before you can write content that people will like to read, you must first have a good command of English. Understanding tenses and punctuation and learning how to make a good paragraph.
Constructing good sentences is one of the ways to differentiate the experienced technical writer from the newbie.
2. Building your writing skill
Building your writing skills while starting your technical writing career is crucial. No matter the number of writing boot camps you have joined or online courses you have taken, you need to write consistently to see remarkable changes.
Building your writing skills means reading other writers' articles, and also it means that you need to write more. The more you write, the more you gain mastery over time.
You learn to write by writing, reading, and thinking about how writers have created their characters and invented their stories.
"If you are not a reader, don't think about being a writer." - Jean M. Auel
3. Research
"Research is seeing what everyone else sees and thinking what nobody else thinks." -Szent-Gyorgyi Albert. Research helps you write up-to-date content and understand what the readers want.
It assists you in gathering topic-related information from a variety of sources, including journals, blogs, rival literature, dissertations, whitepapers, and even professional social media, such as LinkedIn.
You must discern helpful information and narrow your research to specific points.
List those points in order of importance to the subject.
Lastly, your research may warrant that you interview current experts in that field or even take their course on the topic you are researching.
4. Audience Survey
One of the ways to create content that is users centric and helpful to readers is by asking the following questions before you start writing:
Your answer to these questions will help you write quality readers-centric content.
5. Content Planning
Planning is key to having a successful execution of anything.
Content planning allows you to have the readers in mind while drafting a content outline.
It helps you to know what to include and what not to include while drafting the content outline.
6. Editing
As a technical writer, the beauty of your work comes out in editing; that is why many organizations have editors. It is in editing that your work comes alive.
While you are starting as a technical writer and don't have an editor, it is vital to learn the rudiments of editing. It is in editing you discover grammatical errors and others.
Pay quality attention to editing; this will make you stand out from other technical writers.
Here are some of the roles that companies expect a technical writer to fill:
1. Technical Writer
While writers can have a profound experience in the area they're writing about, it's beneficial to have at least some practical knowledge of certain aspects of work from a technical standpoint. For example, blockchain writers should know how blockchain works.
2. User Experience (UX) Writer
It refers to communication abilities. A UX writer should be able to write product descriptions and guides. They aim to write about their reader's pain areas and provide solutions.
3. Technical Researcher
Conducting research is one of the fundamental skills for a writer. The technical researcher must refine and streamline their search to gather the most helpful information about a subject swiftly.
4. Documentation Engineer
They are the ones involved in writing documentation for different projects. Some projects may necessitate the creation of many publications on the same topic for readers with varying levels of expertise.
Writers must understand which sources include enough knowledge to assist all readers and then spin the content to appeal to novice and advanced readers.
5. Developer Advocate
They write developer-centric content that drives awareness about the company's product.
A developer advocate is part of developer relations and, as such, is often known as DevRel.
They are the face of the developer team of the company.
1. Taking a Course
The best way to learn these skills is to do an online course. What happens with a course is that it binds you in a structure so that you can learn more efficiently.
The following are the online learning platforms where you can take courses on technical writing.
a). Coursera
https://www.coursera.org/learn/engineering-writing
b). Udemy
https://www.udemy.com/topic/technical-writing/
c). Google Technical Writing Course
https://developers.google.com/tech-writing
2. Self-Training
Self-training is essential. Even when taking a course, you must learn on your own.
You can begin by reading several books on the subject and digesting a large amount of knowledge. After all, being unique is essential, and if you can discover something by self-studying, then only you can produce some unique technical content.
3. Learn from a Professional
If you know someone who has been in this profession for a long time, you can also take shelter in their mentorship.
4. Learn on the Job
You need to keep learning. Every day something new is coming up, so you must keep up with those things.
The technical writers in this list are amazing people; you should learn from their experience.
Just as iron sharpens iron, so also writers can sharpen each other.
It is good to write consistently. However, your write-ups should not be in your google docs; you have to publish them for people to read, so you can benefit from all the gains they provide.
Here are the platforms that I can recommend for you:
Ask your favorite DevRel person if they need a good writer; you can help to build the subsequent integration, docs, or that pending blog post.
Becoming a technical writer is viable if you enjoy writing and dealing with technology.
To deliver effective instruction and outstanding writing abilities, you should have a decent background in English, which you can get by completing online classes or studying the topic.
Gone are the days when only graduates from the English or communication department in university or college could be technical writers.
Currently, no degree is required; you only need a good portfolio that you can show the employer as proof that you have written a technical article before, and you can help them write the technical content they desire.
According to Glassdoor, the national average base salary for technical writers is $77,812. Additionally, the average salary range is between $39,000 and $155,000.
Some tech companies offer technical writers $100 to $600 per article they publish on their platforms. Some hire technical writers with a minimum hourly pay of $35.
Suppose you love to create content focusing on various Web3 topics. QuickNode has an excellent authorship program. You will get paid $350 per article. That's a way to start your technical writing.
Finally, if you want to work as a technical writer, discover which specialized content type best suits your writing skills and employment requirements.
To some extent, technical writers must be subject matter specialists because they produce the material that professionals in a field would study to become experts in their area.
Their competence stems from extensive theoretical research into a professional field or issue and creating content based on their findings.
The key to success is to begin writing. No tricks or shortcuts are needed; start creating.
