Thread by @CryptoJobsList

A recap of 𝗕𝗲𝗰𝗼𝗺𝗶𝗻𝗴 𝗮 𝗧𝗲𝗰𝗵𝗻𝗶𝗰𝗮𝗹 𝗪𝗿𝗶𝘁𝗲𝗿 𝗶𝗻 #𝗪𝗲𝗯𝟯 Twitter Space with @akegaviar from @ChainstackHQ

What technical writing is and how to seize the opportunity 🧵 👇

First, let's understand what is the difference between 𝗧𝗲𝗰𝗵𝗻𝗶𝗰𝗮𝗹 𝗪𝗿𝗶𝘁𝗶𝗻𝗴 and other types of writing:

General 𝗪𝗿𝗶𝘁𝗶𝗻𝗴 tends to be more on the self-indulgent side where you (the person communicating) care less about the person on the other side of your communication.

With 𝗧𝗲𝗰𝗵𝗻𝗶𝗰𝗮𝗹 𝗪𝗿𝗶𝘁𝗶𝗻𝗴, there is almost zero self-indulgence and entertainment. 100% focus on the end user. You are there to help the user in the time of need. Everybody comes to read the docs to 𝗹𝗲𝗮𝗿𝗻, not to get entertained.

Everyone wants to get through the learning process as quickly and as painlessly as possible and be at same time efficient as possible.

And you, the technical writer, is making sure of that.

𝘌𝘢𝘴𝘺 𝘳𝘦𝘢𝘥𝘪𝘯𝘨 𝘪𝘴 𝘩𝘢𝘳𝘥 𝘸𝘳𝘪𝘵𝘪𝘯𝘨.

𝗜𝗳 𝘆𝗼𝘂 𝗮𝗿𝗲 𝗮𝗹𝗿𝗲𝗮𝗱𝘆 𝗮 𝗧𝗲𝗰𝗵𝗻𝗶𝗰𝗮𝗹 𝗪𝗿𝗶𝘁𝗲𝗿, looking to transition into #Web3, do these 3 things: 👇

1) Adopt a developer mindset. Stop thinking you can't code and build a simple app. It's a lot easier in Web3 than it is in your current prop-tech company.

2) Learn to work with the community and do PRs (pull requests on Github). This means not flat out going to overwrite somebody's text (as you are used to) but guiding them to the final piece with your comments.

3) Start contributing to the docs of Web3 projects (80% of them are live on GitHub). They 𝘸𝘪𝘭𝘭 appreciate it, and it's the easiest and the most positive way for you to build your portfolio while also learning Web3. It's a win-win-win all around.

𝗜𝗳 𝘆𝗼𝘂 𝗮𝗿𝗲 𝗻𝗲𝘄 𝘁𝗼 𝗧𝗲𝗰𝗵𝗻𝗶𝗰𝗮𝗹 𝗪𝗿𝗶𝘁𝗶𝗻𝗴 & want to succeed in web3, we have good news for you!

You don't have the weight of the proprietary web2 tech writing culture on your shoulders. And that's a great start!

Do these 5 things to succeed: 👇

1) Search for any 𝘁𝗲𝗰𝗵 𝘄𝗿𝗶𝘁𝗶𝗻𝗴 𝗰𝗼𝘂𝗿𝘀𝗲 with decent reviews. (They are not expensive). The course will not make you a tech writer, but it will show you all the directions in which you need to learn and practice.

2) Search for "𝗱𝗼𝗰𝘂𝗺𝗲𝗻𝘁𝗮𝘁𝗶𝗼𝗻 𝘀𝘁𝘆𝗹𝗲 𝗴𝘂𝗶𝗱𝗲𝘀" of your favorite Web2 or Web3 company. Start adopting the style guides in your writing.

Examples:
👉 github.com/chainstack/doc…
👉 developers.google.com/style
👉 digitalocean.com/community/tuto…

3) Learn 𝗠𝗮𝗿𝗸𝗱𝗼𝘄𝗻.

It'll help you in your career tremendously. Even chat apps like Telegram, Slack, Discord support it.

Here is a handy cheatsheet markdownguide.org/cheat-sheet/

4) Learn the basics of 𝗴𝗶𝘁 𝗮𝗻𝗱 𝗚𝗶𝘁𝗵𝘂𝗯. Start by learning about 𝗰𝗼𝗺𝗺𝗶𝘁𝘀, 𝗯𝗿𝗮𝗻𝗰𝗵𝗲𝘀 and 𝗽𝘂𝗹𝗹 𝗿𝗲𝗾𝘂𝗲𝘀𝘁𝘀.

Tip: use a git app with UI, if you are not a fan of command line prompt:
☑ docs.github.com/en/pull-reques…
☑ git-scm.com/downloads/guis

5) Contribute to Web3. Now that you are armed with understanding tech writing and style guides, go and contribute to Web3 projects to learn, practice, and build your portfolio.

Again, it's a win-win-win for all the parties involved.

You are doing a great thing. 👍

Bonus point:

Apply to Technical Writer jobs on @CryptoJobs List:

⭐ cryptojobslist.com/jobs/technical… by @akeGaviar of @ChainstackHQ

Good luck! 🚀

You can listen to the the full recording of the conversation in the "Work in Crypto" podcast.

Find it and subscribe in your fav podcasting app.

share.transistor.fm/s/b1238519