Athena — mahmoud-consultancy/archive/old-docs/implementation/KB_CONTENT_WRITING_GUIDE.md


title: Knowledge Base - Content Writing Guide date: 2025-10-15 status: Active Template tags: [knowledge-base, content, writing, templates]

Knowledge Base Content Writing Guide

Complete guide for writing high-quality Knowledge Base articles for InterimPlaza.


Content Standards

Writing Principles

  1. Clear and Concise - Use simple, direct language
  2. Actionable - Provide practical tips and steps
  3. SEO-Optimized - Target specific keywords
  4. User-Focused - Answer real user questions
  5. Professional Tone - Maintain credibility
  6. Dutch Language - Natural, professional Dutch

Article Structure

Every article should have:

  • Title (H1) - Clear, keyword-rich
  • Introduction - Hook + what reader will learn
  • Body - 3-7 sections with H2/H3 headings
  • Conclusion - Summary + call-to-action
  • Related Links - 2-3 related articles

Article Templates

Template 1: "How To" Articles

Example: "Hoe schrijf je de perfecte IT CV?"

# [How to do X]: Complete Guide

## Inleiding
[Hook: Why this matters]
[What reader will learn]
[Who this is for]

## Wat heb je nodig?
- [Prerequisite 1]
- [Prerequisite 2]
- [Prerequisite 3]

## Stap 1: [First Step]
[Detailed explanation]
[Example or screenshot]
**Tip:** [Helpful tip]

## Stap 2: [Second Step]
[Detailed explanation]
[Example]
**Let op:** [Warning if applicable]

## Stap 3: [Third Step]
[Continue for 5-7 steps]

## Veelgemaakte Fouten
1. **[Mistake 1]** - [How to avoid]
2. **[Mistake 2]** - [How to avoid]
3. **[Mistake 3]** - [How to avoid]

## Checklist
- [ ] [Action 1]
- [ ] [Action 2]
- [ ] [Action 3]

## Conclusie
[Summary of key points]
[Call to action: Apply now, Read more, etc.]

## Gerelateerde Artikelen
- [Related article 1]
- [Related article 2]
- [Related article 3]

Template 2: Comparison Articles

Example: "InterimPlaza vs Brunel: Wat zijn de verschillen?"

# [A] vs [B]: Complete Vergelijking

## Inleiding
[Why this comparison matters]
[What you'll learn]

## Overzicht

| Aspect | [A] | [B] |
|--------|-----|-----|
| [Factor 1] | [Detail] | [Detail] |
| [Factor 2] | [Detail] | [Detail] |
| [Factor 3] | [Detail] | [Detail] |

## [Aspect 1]: [Title]

### [Company A]
[Details, pros, cons]

### [Company B]
[Details, pros, cons]

**Winner:** [A/B or "Depends on..."]

## [Aspect 2]: [Title]
[Repeat structure]

## [Aspect 3]: [Title]
[Repeat structure]

## Voor- en Nadelen Samenvatting

### [Company A]
**Voordelen:**
- [Pro 1]
- [Pro 2]
- [Pro 3]

**Nadelen:**
- [Con 1]
- [Con 2]

### [Company B]
**Voordelen:**
- [Pro 1]
- [Pro 2]

**Nadelen:**
- [Con 1]
- [Con 2]
- [Con 3]

## Voor Wie is [A] het Beste?
- [User type 1]
- [User type 2]
- [User type 3]

## Voor Wie is [B] het Beste?
- [User type 1]
- [User type 2]

## Conclusie
[Summary]
[Recommendation]

## Veelgestelde Vragen
**Q: [Question 1]?**
A: [Answer]

**Q: [Question 2]?**
A: [Answer]

Template 3: Explainer Articles

Example: "Wat is detachering? Complete uitleg"

# Wat is [Topic]? Complete Uitleg

## Inleiding
[Hook: Common misconception or statistic]
[What reader will understand after reading]

## Definitie
**[Topic]** is [clear, one-sentence definition].

[Expanded explanation in 2-3 paragraphs]

## Hoe Werkt Het?
1. **[Phase 1]**
   - [Detail]
   - [Detail]

2. **[Phase 2]**
   - [Detail]
   - [Detail]

3. **[Phase 3]**
   - [Detail]
   - [Detail]

## Voorbeeld uit de Praktijk
[Real-world example or case study]
[Make it relatable]

## Voordelen
1. **[Benefit 1]**
   - [Explanation]

2. **[Benefit 2]**
   - [Explanation]

3. **[Benefit 3]**
   - [Explanation]

## Nadelen
1. **[Drawback 1]**
   - [Explanation]
   - [How to mitigate]

2. **[Drawback 2]**
   - [Explanation]
   - [How to mitigate]

## Veelgestelde Vragen
[5-10 common questions with answers]

## Conclusie
[Summary]
[Next steps]

## Hulpbronnen
- [External link 1]
- [External link 2]
- [Related InterimPlaza service]

Template 4: List Articles

Example: "10 Veelgemaakte Fouten in IT CV's"

# [Number] [Topic]: Complete Overzicht

## Inleiding
[Why this list matters]
[What reader will avoid/gain]

## 1. [Item 1]
**Wat:** [Clear description]
**Waarom het fout is:** [Explanation]
**Hoe te voorkomen:** [Solution]
**Voorbeeld:** [Good vs bad example]

## 2. [Item 2]
[Repeat structure]

## 3. [Item 3]
[Repeat structure]

[Continue for all items]

## Samenvatting
Quick checklist of all points:
- ✅ [Do this]
- ❌ [Don't do this]
- ✅ [Do this]
- ❌ [Don't do this]

## Conclusie
[Key takeaway]
[Call to action]

## Volgende Stappen
1. [Action 1]
2. [Action 2]
3. [Action 3]

Priority Articles to Write

Category 1: Detachering Info (Week 4, Day 1-2)

Article 1.1: "Wat is detachering? Complete uitleg voor IT'ers" (2 hours)

Target Keywords: "wat is detachering", "detachering it", "detachering uitleg" Length: 1500-2000 words Template: Explainer Outline:

  • Definitie van detachering
  • Hoe werkt detachering?
  • Verschil met ZZP en payroll
  • Voordelen voor IT professionals
  • Nadelen en hoe ze te vermijden
  • Juridische aspecten
  • Praktijkvoorbeeld
  • FAQ (10 vragen)

Article 1.2: "ZZP vs Payroll vs Detachering: De verschillen" (1.5 hours)

Target Keywords: "zzp vs detachering", "zzp of payroll", "verschil zzp detachering" Length: 1200-1500 words Template: Comparison Outline:

  • Overzichtstabel
  • Belasting en administratie
  • Inkomen en tarieven
  • Zekerheid en rechten
  • Pensioenopbouw
  • Voor wie is wat het beste?
  • Overstap mogelijkheden

Article 1.3: "Voordelen van detachering voor IT professionals" (1 hour)

Target Keywords: "voordelen detachering", "detachering voordelen it" Length: 1000-1200 words Template: List Outline:

  • 7 belangrijkste voordelen
  • Inkomen en tarieven
  • Werkzekerheid
  • Netwerk opbouwen
  • Diverse projecten
  • Geen administratieve rompslomp
  • Pensioen en verzekeringen
  • Opleidingsmogelijkheden

Article 1.4: "Rechten en plichten als gedetacheerde" (1 hour)

Target Keywords: "rechten gedetacheerde", "plichten detachering" Length: 1000-1200 words Template: How-to/Explainer Outline:

  • Arbeidsrechten
  • Cao toepassing
  • Vakantiedagen
  • Ziekte en arbeidsongeschiktheid
  • Ontslag en opzegging
  • Inlener vs uitlener
  • Wat te doen bij problemen

Article 1.5: "Tarieven onderhandelen: Tips voor detacheerders" (1.5 hours)

Target Keywords: "tarieven onderhandelen", "detachering tarief", "hoeveel vragen als detacheerder" Length: 1200-1500 words Template: How-to Outline:

  • Marktconform tarief bepalen
  • Voorbereiding op onderhandeling
  • 10 onderhandelingstips
  • Wat te doen bij afwijzing
  • Wanneer akkoord gaan
  • Contractonderhandeling
  • Verhoging na periode

Category 2: Bureau Comparison (Week 4, Day 2)

Article 2.1: "InterimPlaza vs Brunel: Wat zijn de verschillen?" (1.5 hours)

Target Keywords: "interimplaza brunel", "interim bureau vergelijking" Length: 1200-1500 words Template: Comparison Outline:

  • Bedrijfsprofiel beide
  • Tariefstructuur vergelijking
  • Service niveau
  • Specialisaties
  • Transparantie
  • Klantervaringen
  • Voor wie is wat geschikt

Article 2.2: "Waarom kiezen IT'ers voor InterimPlaza?" (1 hour)

Target Keywords: "interimplaza review", "waarom interimplaza" Length: 1000 words Template: Explainer Outline:

  • Transparante tarieven
  • Directe communicatie
  • Specialisatie IT
  • Geen lock-in contracten
  • Persoonlijke begeleiding
  • Netwerk en community
  • Succesverhalen

Article 2.3: "Onze tariefstructuur volledig uitgelegd" (1 hour)

Target Keywords: "interimplaza tarieven", "detachering kosten" Length: 800-1000 words Template: Explainer Outline:

  • Hoe bepalen wij tarieven
  • Onze fee transparant
  • Wat krijg jij netto
  • Geen verborgen kosten
  • Voorbeeld berekeningen
  • Vergelijking met markt

Category 3: CV & Sollicitatietips (Week 4, Day 3)

Article 3.1: "De perfecte IT CV schrijven in 2025" (2 hours)

Target Keywords: "it cv schrijven", "perfecte cv", "cv template it" Length: 2000+ words Template: How-to Outline:

  • Structuur van een IT CV
  • Contact informatie
  • Professionele samenvatting
  • Technische skills sectie
  • Werkervaring beschrijven
  • Projecten en portfolio
  • Opleidingen en certificaten
  • Hobbys wel/niet vermelden
  • Lengte van CV
  • Design en opmaak
  • CV checklist
  • Downloadbare template

Article 3.2: "Welke skills moet je benadrukken als IT'er?" (1.5 hours)

Target Keywords: "it skills cv", "belangrijke it skills", "skills benadrukken" Length: 1200-1500 words Template: List + How-to Outline:

  • Hard skills vs soft skills
  • Meest gevraagde technische skills 2025
  • Soft skills die recruiters zoeken
  • Hoe skills beschrijven
  • Skills matrix opzetten
  • Certificeringen vermelden
  • Bewijs van skills
  • Skills die je niet moet vermelden

Article 3.3: "10 Veelgemaakte fouten in IT CV's" (1 hour)

Target Keywords: "cv fouten", "fouten cv vermijden", "cv tips" Length: 1000-1200 words Template: List Outline:

  • Te lang CV
  • Geen relevante keywords
  • Algemene skills zonder bewijs
  • Slechte opmaak
  • Grammaticafouten
  • Foto wel/niet
  • Irrelevante werkervaring
  • Ontbrekende contactinfo
  • Geen LinkedIn profiel
  • Hobbyoverdaad

Article 3.4: "LinkedIn profiel optimaliseren voor IT'ers" (1.5 hours)

Target Keywords: "linkedin optimaliseren", "linkedin profiel it", "linkedin tips" Length: 1500 words Template: How-to Outline:

  • Professionele foto
  • Pakkende headline
  • About sectie schrijven
  • Werkervaring optimaliseren
  • Skills endorsements
  • Aanbevelingen vragen
  • Content publiceren
  • Netwerk uitbreiden
  • Recruiter zichtbaarheid

Article 3.5: "Sollicitatiegesprek: 20 veelgestelde vragen" (1.5 hours)

Target Keywords: "sollicitatievragen it", "interview vragen", "sollicitatiegesprek voorbereiden" Length: 1500-1800 words Template: List Outline:

  • 20 vragen met modelantwoorden
  • Gedragsvragen
  • Technische vragen
  • Situatie vragen
  • Vragen aan interviewer
  • Voorbereiding tips
  • Wat niet te doen

Category 4: Marktinformatie (Week 4, Day 4)

Article 4.1: "IT tarieven 2025: Overzicht per specialisatie" (2 hours)

Target Keywords: "it tarieven 2025", "zzp tarieven it", "detachering tarieven" Length: 1800-2000 words Template: List + Data Outline:

  • Methodologie (hoe data verzameld)
  • Gemiddelde tarieven tabel
  • Java Developer (junior/medior/senior)
  • .NET Developer
  • Frontend Developer (React/Angular/Vue)
  • Backend Developer
  • Full Stack Developer
  • DevOps Engineer
  • Cloud Architect
  • Security Specialist
  • Data Engineer
  • Regionale verschillen
  • Trends en voorspellingen

Article 4.2: "Junior vs medior vs senior: Tarief verschillen" (1 hour)

Target Keywords: "junior medior senior verschillen", "it tarieven niveaus" Length: 1000-1200 words Template: Comparison + Explainer Outline:

  • Definitie junior/medior/senior
  • Ervaring vereisten
  • Verantwoordelijkheden
  • Tarief ranges per niveau
  • Hoe doorgroeien
  • Wanneer ben je senior

Article 4.3: "Meest gevraagde IT skills in 2025" (1.5 hours)

Target Keywords: "gevraagde it skills", "it skills 2025", "populaire programmeer talen" Length: 1200-1500 words Template: List + Trends Outline:

  • Top 10 programmeer talen
  • Cloud platforms (AWS/Azure/GCP)
  • DevOps tools
  • AI/ML skills
  • Security skills
  • Soft skills in demand
  • Opkomende technologieën
  • Skills die verdwijnen
  • Hoe jezelf bijscholen

Category 5: FAQ (Week 4, Day 4-5)

Article 5.1: "Hoe werkt het sollicitatieproces?" (45 min)

Target Keywords: "sollicitatie proces interimplaza", "hoe solliciteren" Length: 800 words Template: Explainer + How-to Outline:

  • Stap 1: CV uploaden
  • Stap 2: Screening
  • Stap 3: Kennismaking
  • Stap 4: Matching met opdracht
  • Stap 5: Introductie bij opdrachtgever
  • Stap 6: Contract en start
  • Gemiddelde doorlooptijd
  • Wat we van jou verwachten

Article 5.2: "Hoe lang duurt de plaatsingsprocedure?" (30 min)

Keywords: "plaatsing duur", "hoe snel aan opdracht" Length: 600 words

Article 5.3: "Wat staat er in mijn contract?" (1 hour)

Keywords: "detachering contract", "arbeidscontract detachering" Length: 1000 words

Article 5.4: "Wanneer krijg ik mijn salaris?" (30 min)

Keywords: "salaris uitbetaling", "wanneer salaris" Length: 600 words

Article 5.5: "Is er opleidingsbudget beschikbaar?" (45 min)

Keywords: "opleidingsbudget", "training detachering" Length: 800 words

[Continue for 5 more FAQ articles - 30 min each]


Category 6: Success Stories (Week 4, Day 5)

Article 6.1: "Van junior naar senior in 2 jaar: Mark's verhaal" (1 hour)

Keywords: "carriere groei it", "succesverhaal it" Length: 1000-1200 words Template: Story/Interview Outline:

  • Achtergrond Mark
  • Situatie voor InterimPlaza
  • Eerste opdracht
  • Leermomenten
  • Doorgroei
  • Huidige situatie
  • Tips voor anderen
  • Conclusie

Article 6.2: "ZZP naar detachering: Waarom Lisa de switch maakte" (1 hour)

Keywords: "van zzp naar detachering", "zzp nadelen" Length: 1000 words Template: Story Outline:

  • Lisa's ZZP ervaring
  • Uitdagingen als ZZPer
  • Waarom detachering overwegen
  • De switch
  • Verschillen ervaren
  • Voor- en nadelen
  • Geen spijt

Writing Workflow

Before Writing

  1. Research keywords - Google Keyword Planner, Ubersuggest
  2. Check competition - What do others write about?
  3. Define target audience - Junior/medior/senior?
  4. Set word count goal - Based on competition
  5. Create outline - Use templates above

During Writing

  1. Write first draft - Don't edit yet
  2. Add examples - Make it practical
  3. Include data - Statistics, numbers, facts
  4. Use subheadings - Every 200-300 words
  5. Add images - Screenshots, diagrams, photos
  6. Internal links - Link to other KB articles
  7. External links - Authoritative sources

After Writing

  1. SEO check - Keywords in title, headings, first paragraph
  2. Readability - Flesch reading ease > 60
  3. Grammar - Use spelling checker
  4. Formatting - Proper markdown
  5. Meta description - 150-160 characters
  6. Featured image - Relevant, optimized
  7. Peer review - Have someone else read
  8. Publish & monitor - Track performance

SEO Guidelines

Keyword Placement

  • Title (H1): Primary keyword at the start
  • First paragraph: Primary keyword in first 100 words
  • Headings (H2/H3): Variations of primary keyword
  • Throughout content: 1-2% keyword density
  • Meta description: Primary keyword included
  • URL/Slug: Primary keyword in slug

On-Page SEO Checklist

  • [ ] Title tag 50-60 characters
  • [ ] Meta description 150-160 characters
  • [ ] URL slug keyword-rich, lowercase, hyphens
  • [ ] H1 tag (only one per page)
  • [ ] H2/H3 tags with keywords
  • [ ] Images with alt text
  • [ ] Internal links (3-5 per article)
  • [ ] External links to authoritative sites
  • [ ] Mobile-friendly formatting
  • [ ] Reading time calculated

Content Calendar

Week 4 of Sprint 5 (Nov 18-22)

Monday (8 hours):

  • Article 1.1: Wat is detachering (2h)
  • Article 1.2: ZZP vs Payroll (1.5h)
  • Article 1.3: Voordelen detachering (1h)
  • Article 1.4: Rechten en plichten (1h)
  • Article 1.5: Tarieven onderhandelen (1.5h)
  • Buffer (1h)

Tuesday (8 hours):

  • Article 2.1: InterimPlaza vs Brunel (1.5h)
  • Article 2.2: Waarom InterimPlaza (1h)
  • Article 2.3: Tariefstructuur (1h)
  • Article 3.1: Perfecte CV (2h)
  • Article 3.2: Skills benadrukken (1.5h)
  • Buffer (1h)

Wednesday (8 hours):

  • Article 3.3: CV fouten (1h)
  • Article 3.4: LinkedIn optimaliseren (1.5h)
  • Article 3.5: Sollicitatievragen (1.5h)
  • Article 4.1: IT tarieven 2025 (2h)
  • Article 4.2: Junior vs senior (1h)
  • Buffer (1h)

Thursday (8 hours):

  • Article 4.3: Gevraagde skills (1.5h)
  • Article 5.1-5.10: FAQ articles (5h, 30min each)
  • Buffer (1.5h)

Friday (8 hours):

  • Article 6.1: Mark's verhaal (1h)
  • Article 6.2: Lisa's verhaal (1h)
  • Review all articles (2h)
  • SEO optimization (2h)
  • Upload to CMS (1h)
  • Final testing (1h)

Total: 20 articles in 5 days (40 hours)


Quality Standards

Minimum Requirements

  • [ ] 800+ words (exceptions for short FAQ)
  • [ ] 3+ headings (H2)
  • [ ] 1+ image/screenshot
  • [ ] 2+ internal links
  • [ ] 1+ external link
  • [ ] Meta description written
  • [ ] Primary keyword in title
  • [ ] Spell-checked
  • [ ] Grammar-checked
  • [ ] Peer-reviewed

Excellence Standards

  • [ ] 1500+ words for main articles
  • [ ] 5+ headings with keyword variations
  • [ ] 3+ images/diagrams
  • [ ] 5+ internal links
  • [ ] 3+ authoritative external links
  • [ ] Table/checklist included
  • [ ] Real examples/case studies
  • [ ] Downloadable resource (template, checklist)
  • [ ] Video (optional)
  • [ ] Infographic (optional)

Conclusion

This guide provides everything needed to create high-quality Knowledge Base content. Follow the templates, adhere to SEO guidelines, and maintain quality standards for best results.

Next: Start with Category 1 (Detachering Info) as it's the foundation for understanding all other content.

Reacties

Nog geen reacties