# content-writing Full Instructions ## Core Principles ### Human-First Content - Write for humans first, optimize for search engines second - Focus on providing genuine value to readers - Answer real questions and solve real problems - Use natural, conversational language - Avoid keyword stuffing and unnatural language - **Blog / insights HTML:** Do not paste outline or SEO-tooling language into reader-facing copy (no „PAA“, „SERP“, „SISTRIX“, „Suchanfragen“ as process commentary, or outline filenames). Research stays under `docs/`; see [READER_FACING_COPY_GUARDRAILS.md](../../docs/content/blog/READER_FACING_COPY_GUARDRAILS.md). ### Natural Language Writing - Write naturally, as if speaking to a colleague or friend - Use conversational tone appropriate to audience - Vary sentence length and structure - Include natural transitions - Use contractions when appropriate - Write in active voice (preferred) ### SEO-Optimized Natural Content - Integrate keywords naturally, not forcefully - Include primary keyword in title, H1, first paragraph - Use secondary keywords naturally throughout content - Include synonyms and related terms - Focus on user intent, not just keywords - Write comprehensive content that covers topics thoroughly ### E-E-A-T Implementation **Experience:** - Include first-hand experiences and case studies - Share real-world examples and scenarios - Use specific numbers and data points - Reference actual use cases **Expertise:** - Demonstrate deep topic knowledge - Cite authoritative sources - Provide accurate, detailed information - Show understanding of nuances **Authoritativeness:** - Build domain authority through quality content - Earn backlinks from authoritative sites - Establish topical authority in niche - Maintain consistent quality **Trustworthiness:** - Be transparent about sources and methods - Provide accurate, up-to-date information - Include clear contact information - Regular content updates ## AI Content Avoidance ### Common AI Tells to Avoid - Overly formal language patterns - Repetitive sentence structures - Lack of personal voice/opinions - Generic transitions ("Furthermore", "Moreover", "In conclusion") - Overuse of certain phrases ("It's important to note", "In today's world") - Lack of specific examples or anecdotes - Perfect grammar without natural variations ### Natural Writing Techniques - Vary sentence length and structure - Include personal insights and opinions - Use specific examples and anecdotes - Natural transitions and flow - Conversational tone with occasional contractions - Imperfect but natural grammar patterns **See:** `docs/content/AI_CONTENT_AVOIDANCE_GUIDE.md` for comprehensive guide ## Answer-First and AI Citation - **Answer-first:** 40-60 word direct answer below question headings; first sentence = answer - **Chunk size:** 40-120 words for AI extraction; 250-350 per section - **Entity consistency:** Stable terminology (Probezeit, Kündigungsfrist, etc.) across sections ## Content Structure ### Header Hierarchy - **H1:** Page/post title only (in header component, not in content) - **H2:** Main sections (5-10 for most; 8-12 for main topics) - Each H2 should represent a distinct topic or section - Use descriptive, keyword-rich headings - Question format works well: "Was ist...?", "Wie berechnet man...?" - **H3:** Subsections under H2 (optional, case-by-case) - Use when sections have distinct subtopics, steps, or comparisons **and each item has 2+ sentences**. H2+paragraphs valid. - **Thin H3s (1 sentence) → use list.** H3 per tip only when each tip has 2+ sentences. Otherwise use `