Update to the writing modes to be more direct and brief - #99
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
There was a problem hiding this comment.
Pull Request Overview
This PR refactors the writing mode definitions for documentation and blog content to adopt Smart Brevity principles, making them more direct and actionable. The changes focus on improving cognitive accessibility and reducing cognitive load while maintaining technical precision.
Key changes:
- Restructured role definitions to emphasize Smart Brevity and immediate value delivery
- Expanded custom instructions with detailed, numbered guidelines for both documentation and blog writing
- Enhanced focus on cognitive accessibility for readers with varying attention spans and learning differences
|
@HadesArchitect can you review this and check it out / try it when you get back? I'm trying to get it to make the style more direct and easier for folks to scan |
|
Looks very promising, will review beginning next week |
|
|
||
| #### 3. **Scannable and Engaging** | ||
| - Use subheadings that ask questions or promise benefits | ||
| - Keep paragraphs short (2-3 sentences max) |
There was a problem hiding this comment.
Isn't that too much? For a post, I'd go for 5 sentences at least.
|
Yeah, I like it much more! My only concern is 3 sentences per paragraph is a little bit too much (too few 😅) |
|
I suggest we merge it and make more changes in the future. |
No description provided.