Skip to main content

SEO Content Creation Guide

This guide outlines the best practices for creating search engine optimized content for AppStruct documentation and blog posts.

On-Page SEO Checklist​

Content Structure​

  • Use one H1 heading per page (typically the title)
  • Structure content with logical hierarchy of H2, H3, and H4 headings
  • Keep paragraphs short (2-3 sentences)
  • Use bullet points and numbered lists for scannable content
  • Include a table of contents for longer articles

Keyword Optimization​

  • Include primary keyword in:
    • Title (H1)
    • First paragraph
    • At least one H2 heading
    • Meta description
    • URL slug
    • Image alt text
  • Use related keywords and synonyms naturally throughout
  • Aim for 1-2% keyword density (not too much, not too little)
  • Use LSI keywords (related terms) throughout content

Meta Data​

  • Write a compelling meta description between 140-160 characters
  • Include 5-8 relevant keywords separated by commas
  • Ensure URL slugs are descriptive and contain keywords
  • Use hyphen (-) separators in URLs, not underscores (_)

Images​

  • Use the <Image> component from the ideal-image plugin
  • Provide descriptive alt text for all images
  • Include primary keyword in at least one image alt text
  • Use properly sized and compressed images
  • Follow naming conventions: descriptive-keyword-rich-name.webp

Internal Linking​

  • Include 3-5 internal links to other relevant docs/blog posts
  • Use descriptive anchor text (not "click here" or "read more")
  • Link to high-priority content when appropriate
  • Keep navigation paths logical and helpful

SEO-Optimized Templates​

Documentation Page Template​

---
id: descriptive-id-with-keywords
title: Primary Keyword: Descriptive Title
sidebar_label: Shorter Title
description: 150-160 character description with primary keyword that explains the content and provides value to readers
keywords: [keyword1, keyword2, keyword3, appstruct, relevant-term]
---

# Primary Keyword: Descriptive Title

Brief introduction that includes primary keyword and explains what the reader will learn.

## What You'll Learn
- Key point 1 with secondary keyword
- Key point 2 addressing user need
- Key point 3 with benefit

## First H2 Section with Keyword

Main content with naturally incorporated keywords. Keep paragraphs short and focused.

### Subsection with Related Term

More detailed information organized logically.

![Descriptive alt text with keyword](image-name.webp)

## Second H2 Section with Different Keyword

Continue with valuable content that addresses user needs.

## How AppStruct Solves This Problem

Connect the topic to AppStruct's features and benefits.

## Summary

Recap key points and include a call to action.

Blog Post Template​

---
slug: url-friendly-post-name-with-keywords
title: "Primary Keyword: Compelling Title That Includes Key Phrase"
description: "150-160 character description with primary keyword"
image: ./images/featured-image.webp
keywords: [primary-keyword, secondary-keyword, related-phrase, appstruct]
authors: [Author]
tags: [relevant-tag1, relevant-tag2, appstruct]
date: YYYY-MM-DD
---

import Image from '@theme/IdealImage';

# Primary Keyword: Compelling Title

Introduction with primary keyword in first paragraph.

<Image img={require('./images/featured-image.webp')} alt="Descriptive alt text with keyword" />

## Main Section with Keyword

Content that provides value and naturally incorporates keywords.

## Another Important Section

More valuable content with internal links to [other relevant content](/docs/related-topic).

## Conclusion with Call to Action

Summary and next steps for the reader.

SEO Analytics Review Checklist​

Regularly review these metrics to measure and improve SEO performance:

  • Page load speed (aim for under 3 seconds)
  • Bounce rate (aim for under 60%)
  • Average time on page (aim for over 2 minutes)
  • Search impressions and clicks
  • Ranking position for target keywords
  • Mobile responsiveness score

Following these guidelines will help ensure all AppStruct content is optimized for search engines while providing valuable information to users.