tl;dr:
Whenever possible, always frame the main topic in terms of “you” the reader rather than “I” the writer or “we” the company.
The simplest way to approach this is to take on the perspective of the reader and ask, “What’s in it for me?”
The reader is mostly not interested in what you are doing or your reasons for doing it. They want to know what they will get out of reading this article (and by extension, using this product).
This is especially important for titles, headlines, and introductions, because this is where you need to hook the reader and convince them to continue.
❌ We just released a new feature—look at what a great job we did.
✅ You can do amazing things with this feature—here’s why you’ll love it.
For more info on how to write better headlines for articles, check out @Sam Sycamore’s blog post on the topic.
What do you want the reader to do after they’ve finished reading your article or document?
The final section of a blog post should almost always contain (no more than) one clear call to action at the end of the piece. A call to action is most effective when it is concrete and contextual.
The more specific, the better.
❌ Try the MUI X Data Grid today, and give us some feedback, either on GitHub or Stack Overflow, or email us, or reply to one of our posts on Twitter, or just DM any of the maintainers on LinkedIn.
✅ Have you tried out the latest feature yet? We’d love to hear your feedback—please raise an issue on GitHub if you find any room for improvement.