Notes

Writing a technical article

The subject
The target
The goal
The tone

Structure

Headline - short & precise - grab attention - promise to fulfill
Intro - set frame of article - hook them in - emotion / pathos in intro
Body - Logical sequence of steps
Conclusion - fulfil promise from headline - tweetable wrap up

General

Avoid long words / jargon
Keep metaphors simple / no idioms
Active voice