|
| 1 | +--- |
| 2 | +description: Use these guidelines specifically for editing |
| 3 | +globs: |
| 4 | +alwaysApply: false |
| 5 | +--- |
| 6 | +Use these guidelines **specifically for editing**—from initial content review to the final polish—ensuring the writing remains clear, consistent, and aligned with the author’s intent: |
| 7 | + |
| 8 | +1. **Overall Tone & Authenticity** |
| 9 | + - Verify that the voice is friendly, consistent, and genuine (e.g., “Howdy?”, “Hope it helps”). |
| 10 | + - Eliminate unnatural or inappropriate expressions. |
| 11 | + - Preserve the author’s unique style and voice when making edits. |
| 12 | + |
| 13 | +2. **Natural Flow & Readability** |
| 14 | + - Identify robotic, stiff, or awkward phrasing. |
| 15 | + - Propose improvements for sentence variety, paragraph structure, and transitions. |
| 16 | + - *Example*: “This sentence might flow better as: ‘We discovered that most users prefer simplicity over complexity.’” |
| 17 | + |
| 18 | +3. **Grammar & Spelling** |
| 19 | + - Correct mistakes proactively, marking deletions (strikethrough) and additions (**bold**) clearly. |
| 20 | + - *Example*: “In paragraph two, ‘their’ should be ‘there.’” |
| 21 | + - Monitor repetitive errors; maintain consistent usage and style throughout. |
| 22 | + |
| 23 | +4. **Technical Accuracy** |
| 24 | + - Flag potentially outdated or incorrect facts, statistics, or code snippets. |
| 25 | + - Encourage the author to verify any specialized information. |
| 26 | + - Keep the intended audience (e.g., **backend developers, beginner and above**) in mind when suggesting edits. |
| 27 | + |
| 28 | +5. **Tone Moderation** |
| 29 | + - Rein in overly hyperbolic or excessive enthusiasm. |
| 30 | + - Replace superlatives (“absolutely amazing,” “unbelievably powerful”) with more balanced language. |
| 31 | + - *Example*: Transform “This amazingly brilliant feature completely transforms development” into “This useful feature significantly improves development.” |
| 32 | + |
| 33 | +6. **Tagging Guidelines** |
| 34 | + - If applicable, ensure tags use **lowercase, hyphenated** formats (e.g., `functional-programming`). |
| 35 | + - Keep tags concise (1–3 words) and aim for 3–7 per post. |
| 36 | + - Reuse existing tags when possible, mixing broad tags (`programming`) with more specific ones (`algebraic-effects`). |
| 37 | + - Proofread tags for typos or inconsistencies before finalizing. |
| 38 | + |
| 39 | +7. **Final Review** |
| 40 | + - Suggest reading the text aloud to catch lingering awkwardness or tonal shifts. |
| 41 | + - Summarize the piece’s strengths and highlight any last improvements. |
| 42 | + - Double-check that edits, tags, and technical details align with the author’s overall goals and style. |
0 commit comments