Writing as clueless as a rookie gold digger? This article may help you.
A few days ago, I had the honor to participate in the fourth session of [Creators Training Camp], and I also got a lot of useful writing skills in the live broadcast. Now for the second time, I would like to summarize the major elements of zhang Xinxu’s writing experience for you.
⭐ For those of you who didn’t have time or missed the broadcast, or who just want to review, I hope this article has been helpful.
Live instructor: Zhang Xinxu
Live topic: 12 years of technical writing experience sharing
Introduction: reading group front-end technical experts, is also a blogger, xin xin space life for more than a decade has been not compose, created nearly 800 front-end technology original article, and author of a book “CSS world” CSS selector to the world and the CSS in the new world, in the front end of the field associated with the user experience more research result.
Live playback: Zhang Xinxu sharing 12 years of technical writing experience
1. Preface: Why can’t you think of things to share?
- Always trying to make waves
- To be scarce
- To elaborate
- To dry
- The insecurity that fear brings
- Fear of content doesn’t work
- Fear of bad typography
- Fear of revealing rookie level
⭐ in fact, we should not let these factors cause us to write difficult, we should consider more is “what do I have”? !
- Who am I?
- How’s my energy?
- How good am I?
- What are my strengths?
- Where is my breakthrough?
2. About the writing topic
Writing topic
01 New features, new methods (suitable for newcomers) : recommend Can I Use website
02 A small skill or creation that you think is awesome
03 Principle analysis and in-depth understanding
04 Summary of technical solutions (suitable for newcomers)
Sharing experience in solving intractable problems
06 Excellent Framework, project, tool experience guide (suitable for newcomers)
advice
(1) Topic selection is related to my own learning
- Writing is an aid to learning
- Easy to insist, no one to look at the calculation, their own harvest growth
(2) Don’t write the same content
- The same knowledge can be cut from different points
(3) Write personal stories, feelings and perplexities when confused
- Both to find answers and to gain access
3. Content structure
🙄 Your writing purpose determines the structure of your content!
The utility of writing
🌈 If you’re writing for a promotion, a raise, a job change, or fame. So your writing needs to be a little bit more structured, which is embodied in two things: focus and progression.
An emphasis on
A quick glance at what you’re talking about
- Conclusion: conclusion comes first
- Talk about interactive: effect first
- List knowledge: Need a clear list
There are closed loops and there are progressions
Complete story-like expression
- Background, thinking, attempts, difficulties, solutions and results
- Difficulties are divided into 1, 2, 3. What new problems arise after solving them
Daily writing
👨💻 if it is for learning and self-growth, personal presentation. So follow your heart is the most important, less routine, more sincere. Because a heart that truly wants to share is more effective than any random technique.
🚀 Remember: don’t try to please everyone in your writing. An article that pleases everyone must be middle-of-the-road, i.e. dull and boring. Otherwise, the final article must be flat, unable to stand out!
Take a look at zhang Xinxu’s article structure (various, remember as you please)
4. About language expression
The perspective-taking
🤔 first throws out a question: what is the most important language expression of technical articles?
- Concise statement? ❌
- Flowery words? ❌
- Funny jokes? ❌
All is not! The most important thing is the ability to put yourself in others’ shoes.
- If I were white, would you understand the terms?
- If I were a reader, would it make sense?
- Is there a familiar analogy?
- Does the code need to be simplified and commented out?
- Should I put a picture here?
- Should there be a demonstration here?
Opinion: Apart from serious scenarios such as work reports and team accounts, articles with personal feelings must be more valuable!
Show your true self
For example: What kind of problem am I having? How do I think? How did I solve it?
What do I think of the technology? I’m not a big fan of design, okay? What would I suggest?
What style do you use for who you are
Reject the template and show your true self!
I talk too much, I like to talk too much, you do that, you say what comes to mind!
I am an otaku. Articles can reflect various elements of otaku.
I like to show myself, so I’ll show you a lot of pictures with this article.
I am poor small transparent, the article does not have to force a smile, revealed that melancholy is very good!
😶 The true self is easier to empathize with! And maintaining a consistent style and character has many advantages:
- Bad style is better than no style at all
- Make yourself memorable and make an impact
- One of the means to prevent piracy
5. About the quality of the article
🔮10 hydrology is not as good as 1 high quality good article!
Illustration and demonstration
As the saying goes, “A case is worth a thousand pictures, and a picture is worth a thousand words.”
Be responsible for every word
If you’re unsure of your conclusions, check them out for yourself
For example: in the desktop document. ScrollingElement is the document. The documentElement; The document on the mobile end. ScrollingElement is the document. The body.
🥴 Yes or no? Android and iOS?
Go for the heart, not the hot
There is no positive correlation between article quality and page views
For example, an article like “Interview skills, N characteristics summary” may get high likes, but it won’t necessarily influence you.
conclusion
About the topic of the article: Related to learning, different entry points, feeling and confusion
02 About content structure: focus, closed-loop and progressive, sincere
About language expression: put yourself in others’ shoes, show yourself and keep your style
04 About the quality of the article: illustrations and examples, responsible for the conclusion, the pursuit of the heart
🚄 most of the text is from the live BROADCAST PPT courseware, this article is only a summary, live broadcast replay address has been posted at the beginning of the article.