Skip to content

Latest commit

 

History

History
507 lines (403 loc) · 13.5 KB

File metadata and controls

507 lines (403 loc) · 13.5 KB

SEO Improvements Phase 2 - January 2025

This document outlines the Phase 2 SEO improvements implemented for KanaDojo, building on the Phase 1 critical optimizations.


✅ Phase 2 Completed Improvements

1. Visual Breadcrumb Component with Schema

What was implemented:

  • Created /shared/components/Breadcrumbs/Breadcrumbs.tsx - Visual breadcrumb navigation
  • Integrates with existing BreadcrumbSchema for SEO
  • Accessible navigation with ARIA labels
  • Responsive design with Tailwind CSS

Benefits:

  • Better user navigation and UX
  • Schema-UI alignment (Bing values this highly)
  • Improved accessibility
  • Lower bounce rates from better navigation

Usage Example:

import { Breadcrumbs } from '@/shared/components/Breadcrumbs';

<Breadcrumbs
  items={[
    { name: 'Home', url: '/' },
    { name: 'Academy', url: '/academy' },
    { name: 'Learn Hiragana', url: '/academy/learn-hiragana' }
  ]}
/>

Where to add:

  • Blog post pages
  • Learning section pages (Kana, Kanji, Vocabulary)
  • Academy articles
  • Deep pages (practice, train sections)

2. How-To Schema for Learning Guides

What was implemented:

  • Created /shared/components/SEO/HowToSchema.tsx
  • Structured data for step-by-step learning guides
  • Support for images, videos, time estimates, and cost

Benefits:

  • Appears in Bing rich results for "how to" queries
  • Higher visibility for tutorial content
  • Better click-through rates from search
  • Establishes KanaDojo as educational authority

Usage Example:

import { HowToSchema } from '@/shared/components/SEO';

<HowToSchema
  name="How to Learn Hiragana in One Week"
  description="Master all 46 Hiragana characters with this proven method"
  totalTime="PT7D"
  estimatedCost="0"
  steps={[
    {
      name: "Learn the 5 vowels",
      text: "Start with the basic vowels: あいうえお (a-i-u-e-o). Practice writing each character 10 times.",
      image: "https://kanadojo.com/images/hiragana-vowels.jpg"
    },
    {
      name: "Master K-row characters",
      text: "Learn the K-row: かきくけこ (ka-ki-ku-ke-ko). Associate each with the vowel sound.",
    },
    {
      name: "Practice daily for 20 minutes",
      text: "Use KanaDojo's interactive exercises to reinforce your learning each day.",
    }
  ]}
/>

Recommended for:

  • "How to learn Hiragana"
  • "How to memorize Kanji"
  • "How to prepare for JLPT"
  • "How to improve Japanese pronunciation"
  • Any step-by-step learning guide

3. Enhanced Author Schema for E-E-A-T

What was implemented:

  • Created /shared/components/SEO/AuthorSchema.tsx
  • Comprehensive author credibility markup
  • Support for credentials, expertise, affiliations, experience

Benefits:

  • Stronger E-E-A-T signals for Bing and Google
  • Better rankings for educational content
  • Establishes content creator authority
  • Improves trust signals

Usage Example:

import { AuthorSchema } from '@/shared/components/SEO';

<AuthorSchema
  name="Tanaka Sensei"
  url="https://kanadojo.com/authors/tanaka-sensei"
  image="https://kanadojo.com/images/authors/tanaka.jpg"
  jobTitle="Japanese Language Instructor"
  affiliation="KanaDojo"
  expertise="Japanese Language Education, JLPT Preparation, Hiragana and Katakana instruction"
  yearsOfExperience={15}
  credentials={[
    "JLPT N1 Certified",
    "Licensed Japanese Language Teacher",
    "Master's Degree in Japanese Linguistics"
  ]}
  description="Experienced Japanese language instructor specializing in helping beginners master Hiragana, Katakana, and foundational Japanese."
/>

Recommended for:

  • Blog post authors
  • Course creators
  • Content contributors
  • Tutorial authors

4. Learning Resource Schema

What was implemented:

  • Created /shared/components/SEO/LearningResourceSchema.tsx
  • Structured data for educational resources
  • Support for games, quizzes, courses, tutorials, activities

Benefits:

  • Better discovery in educational search results
  • Bing prioritizes educational content with proper markup
  • Appears in specialized educational search features
  • Clear labeling of difficulty levels and time requirements

Usage Example:

import { LearningResourceSchema } from '@/shared/components/SEO';

<LearningResourceSchema
  name="Hiragana Speed Recognition Game"
  description="Test and improve your Hiragana reading speed with this interactive game"
  url="https://kanadojo.com/kana/blitz"
  learningResourceType="Game"
  educationalLevel={["Beginner", "Intermediate"]}
  teaches="Japanese Hiragana Character Recognition"
  assesses="Reading Speed and Accuracy"
  timeRequired="PT15M"
  inLanguage="ja"
  isAccessibleForFree={true}
  provider={{
    name: "KanaDojo",
    url: "https://kanadojo.com"
  }}
  educationalAlignment={{
    alignmentType: "educationalLevel",
    educationalFramework: "JLPT",
    targetName: "N5-N4"
  }}
/>

Recommended for:

  • Kana practice games (Blitz, Gauntlet)
  • Kanji training exercises
  • Vocabulary quizzes
  • Interactive lessons
  • All practice/train pages

5. Video Schema

What was implemented:

  • Created /shared/components/SEO/VideoSchema.tsx
  • Structured data for video content
  • Support for transcripts, durations, thumbnails

Benefits:

  • Better visibility in Bing video search
  • Rich video results in regular search
  • Bing heavily promotes video content
  • Future-proof for when video content is added

Usage Example:

import { VideoSchema } from '@/shared/components/SEO';

<VideoSchema
  name="How to Write Hiragana あ - Stroke Order Tutorial"
  description="Learn the correct stroke order for the Hiragana character あ with this detailed video guide"
  contentUrl="https://cdn.kanadojo.com/videos/hiragana-a.mp4"
  thumbnailUrl="https://cdn.kanadojo.com/thumbnails/hiragana-a.jpg"
  uploadDate="2025-01-15"
  duration="PT2M30S"
  educationalUse="Instruction"
  inLanguage="ja"
  publisher={{
    name: "KanaDojo",
    logo: "https://kanadojo.com/logo.png"
  }}
/>

Ready for:

  • Future pronunciation videos
  • Stroke order demonstrations
  • Tutorial videos
  • Learning technique videos

6. Enhanced robots.txt

What was implemented:

  • Updated /public/robots.txt with comprehensive bot directives
  • Explicit crawl permissions for Bing, MSN, and BingPreview bots
  • Added social media crawlers (Twitter, Facebook, LinkedIn)
  • Clear directives for all major search engines

Benefits:

  • Better crawl efficiency
  • Explicit Bing bot permissions
  • Social media preview optimization
  • Clear communication with search engines

Additions:

  • Bingbot, msnbot, BingPreview, adidxbot (Bing Ads)
  • Googlebot-Image, Googlebot-Video
  • Twitterbot, facebookexternalhit, LinkedInBot
  • DuckDuckBot, YandexBot, Baiduspider
  • Crawl-delay: 0 for all bots (fast crawling)

📂 Files Created

Components

  1. /shared/components/Breadcrumbs/Breadcrumbs.tsx - Visual breadcrumb component
  2. /shared/components/Breadcrumbs/index.ts - Barrel export

SEO Schemas

  1. /shared/components/SEO/HowToSchema.tsx - How-To structured data
  2. /shared/components/SEO/AuthorSchema.tsx - Enhanced author markup
  3. /shared/components/SEO/LearningResourceSchema.tsx - Educational resource schema
  4. /shared/components/SEO/VideoSchema.tsx - Video content schema
  5. /shared/components/SEO/index.ts - Unified schema exports

Documentation

  1. /docs/SEO_IMPROVEMENTS_PHASE2.md - This document
  2. /TODO_INDEXNOW_SETUP.md - IndexNow setup reminder

📝 Files Modified

  1. /public/robots.txt - Enhanced with Bing-specific directives

🎯 Integration Checklist

Immediate Integration Opportunities

1. Add Breadcrumbs to Key Pages

// In Academy blog posts
<Breadcrumbs items={[
  { name: 'Home', url: '/' },
  { name: 'Academy', url: '/academy' },
  { name: postTitle, url: `/academy/${slug}` }
]} />

// In learning sections
<Breadcrumbs items={[
  { name: 'Home', url: '/' },
  { name: 'Kana', url: '/kana' },
  { name: 'Practice', url: '/kana/train' }
]} />

2. Add How-To Schema to Guides

Create these guides with How-To schema:

  • "How to Learn Hiragana Fast"
  • "How to Memorize Kanji Effectively"
  • "How to Prepare for JLPT N5"
  • "How to Improve Japanese Reading Speed"

3. Add Learning Resource Schema to Practice Pages

  • /kana/blitz - Kana speed game
  • /kanji/blitz - Kanji speed game
  • /vocabulary/blitz - Vocabulary speed game
  • All /train pages
  • All /gauntlet pages

4. Create Author Profiles

  • Add author pages under /authors/[name]
  • Include full AuthorSchema with credentials
  • Link from blog posts

5. Prepare for Video Content

  • Schema is ready for when videos are added
  • Consider adding:
    • Pronunciation videos
    • Stroke order videos
    • Learning technique videos

📊 Expected Impact (Phase 2)

Immediate (1-2 weeks):

  • Better navigation UX from breadcrumbs
  • Clearer crawl signals to search engines
  • Foundation for rich results

Short-term (1-3 months):

  • Appearance in "How-To" rich results
  • Better rankings for educational queries
  • Improved E-E-A-T signals boost rankings
  • Higher CTR from structured data

Long-term (3-6 months):

  • Established as educational authority
  • Better visibility in Bing educational search
  • Higher trust metrics
  • Sustained ranking improvements

🔍 Testing the Implementations

1. Test Breadcrumbs

  • Visual check on pages where implemented
  • Verify accessibility with screen reader
  • Check mobile responsiveness

2. Validate Structured Data

Use these tools:

Example test:

# View generated JSON-LD on a page
curl https://kanadojo.com/academy/post | grep -A 50 "application/ld+json"

3. Monitor in Search Console

  • Bing Webmaster Tools → Structured Data
  • Check for warnings or errors
  • Monitor rich result impressions

💡 Content Creation Opportunities

With these new schemas, create targeted content:

How-To Guides (High Priority)

  1. "How to Learn Japanese Hiragana in 3 Days"

    • Step-by-step breakdown
    • Daily practice schedule
    • Memory techniques
  2. "How to Pass JLPT N5 in 6 Months"

    • Study plan with timeline
    • Resource recommendations
    • Practice strategies
  3. "How to Read Japanese Faster"

    • Speed reading techniques
    • Recognition practice
    • Common patterns
  4. "How to Write Kanji from Memory"

    • Memorization techniques
    • Stroke order practice
    • Mnemonics

Educational Resources

  1. Interactive Hiragana Chart

    • Learning Resource schema
    • Assessment-focused
  2. JLPT Vocabulary Builder

    • By level (N5-N1)
    • Spaced repetition
  3. Kanji Stroke Order Practice

    • Interactive writing
    • Correctness feedback

🚀 Phase 3 Preview (Coming Next)

Potential future improvements:

  1. Real User Review System

    • Replace hardcoded reviews
    • Collect genuine user feedback
    • Display and markup reviews
  2. FAQ Page Enhancement

    • Dynamic FAQ generation
    • Per-page FAQs
    • User-submitted questions
  3. Performance Optimization

    • Core Web Vitals improvements
    • Image lazy loading optimization
    • Font loading optimization
  4. Content Expansion

    • Pillar content creation
    • Comparison pages
    • Glossary/dictionary section
  5. Local Business Schema (if applicable)

    • Company information
    • Support hours
    • Location data

📚 Usage Examples Summary

Quick Reference

// Breadcrumbs
import { Breadcrumbs } from '@/shared/components/Breadcrumbs';
<Breadcrumbs items={breadcrumbItems} />

// How-To Schema
import { HowToSchema } from '@/shared/components/SEO';
<HowToSchema name="..." description="..." steps={[...]} />

// Author Schema
import { AuthorSchema } from '@/shared/components/SEO';
<AuthorSchema name="..." expertise="..." credentials={[...]} />

// Learning Resource
import { LearningResourceSchema } from '@/shared/components/SEO';
<LearningResourceSchema learningResourceType="Game" teaches="..." />

// Video Schema (when ready)
import { VideoSchema } from '@/shared/components/SEO';
<VideoSchema name="..." contentUrl="..." thumbnailUrl="..." />

✅ Verification Checklist

  • Visual breadcrumb component created
  • How-To schema implemented
  • Enhanced author schema created
  • Learning resource schema implemented
  • Video schema prepared
  • robots.txt enhanced
  • All schemas exported in index
  • ESLint checks passed
  • Breadcrumbs added to pages (integration needed)
  • How-To schema added to guides (content creation needed)
  • Author schemas added to blog posts (integration needed)
  • Learning resource schemas added to practice pages (integration needed)
  • Structured data validated in Bing Webmaster Tools (post-deployment)

🆘 Troubleshooting

Breadcrumbs not showing?

  • Check that items array has at least 2 items
  • Verify the component is imported correctly
  • Check className overrides aren't hiding it

Schema validation errors?

  • Use Bing Markup Validator
  • Check for required fields
  • Ensure URLs are absolute (not relative)
  • Verify date formats (ISO 8601)

Rich results not appearing?

  • Can take 1-4 weeks for Bing to process
  • Ensure schema is on live site (not dev)
  • Check Bing Webmaster Tools for errors
  • Verify page is indexed

Implementation Date: January 2025 Status: Phase 2 Complete - Integration Recommended Next Steps: Integrate components into pages, create How-To content Next Review: February 2025