Instruction file imported from alesanchezr/full-stack-with-ai (
.cursor/rules/all-tone-and-voice.mdc). Copyright stays with the author.
This rules apply to all markdown files inside the content/articles folder.
- Speak like a human! Write as if you're explaining things to a friend. Keep it real and relatable.
- Be direct and concise. Get to the point. Use shorter sentences and avoid unnecessary jargon or overly complex wording. If you can say it in fewer words, do it.
- Active voice is your friend. It makes your writing clearer and more engaging.
- Use contractions liberally (e.g., “you've” instead of “you have”) and embrace informal phrasing where it fits.
- Sprinkle in light humor, like relatable quips or playful asides (e.g., "We've all been there, staring at a bug like it's mocking us"). But don't force it if it doesn't feel natural.
- Keep the tone encouraging and supportive with phrases like "don't sweat it" or "you're totally capable of this."
- Use first- and second-person pronouns ("I" and "you") to build a personal connection.
- Steer clear of stiff, formal, or overly academic language. Avoid sounding like a textbook or a research paper.
- Keep the tone inviting so readers feel involved, not just lectured at.
- Use questions or nudges to spark curiosity (e.g., "Ever wondered why that happens?" or "So, what's the deal with...?").
- Break down complex ideas into small, digestible chunks. Use bullet points, numbered lists, and short paragraphs to make information easier to scan and understand.
- Explain technical terms simply. If you have to use a technical term, explain it like you would to someone new to the field (e.g., "A 'variable' is just a fancy box to hold your data"). Use analogies if they help!
- Avoid jargon unless it's defined first—don't assume prior knowledge. If it sounds overly technical, it probably is.
- Use short sentences and clear phrasing to keep the fog away. Read it aloud – if it sounds clunky, simplify it.
- Kick off with reassurance (e.g., "Don't worry, this isn't as tricky as it looks").
- End on a high note with encouragement (e.g., "You've got this—go crush it!").
- Weave in motivational phrases throughout (e.g., "Small steps add up to big wins").
- Make it feel like a pep talk, not a chore. Your enthusiasm (or lack thereof) will come through!
- Authenticity over rigid formality. It's better to sound like a real person than a robot adhering to outdated writing rules.
- Maintain a professional yet conversational written voice: While a friendly and relatable tone is key, ensure that informal expressions are suitable for written articles. Avoid overly colloquial interjections or phrases that mimic verbal pauses (e.g., "whoa there," "nah," "hold on a second") if they feel out of place in text. The goal is a warm, engaging written style, not a direct transcript of casual speech."