Evaluate correct schema.org types for each content section

[leogdion]

Context

Before implementing schema markup in PiHTMLFactory (issues #19, #20), we need to verify that the planned schema types are the right fit for each content section on BrightDigit.com. A Swift agency site has different characteristics than a blog or e-commerce site, and the wrong schema types will produce no AI citation benefit or may be flagged as invalid by Google's Rich Results Test.

Goal

Produce a definitive mapping of schema.org types to content sections, validated against:

• Google's supported rich result types
• schema.org full type hierarchy
• AI citation behaviour (ChatGPT, Perplexity, Google AI Overview)

Sections to Evaluate

Section	Candidate Types	Notes
Articles (/articles/)	Article, TechArticle, BlogPosting	Which signals "technical authority" best to AI?
Tutorials (/tutorials/)	HowTo, TechArticle, LearningResource	HowTo requires step array — is that realistic for long-form tutorials?
Podcast episodes (/episodes/)	PodcastEpisode, AudioObject, VideoObject	Dual audio+video; both may apply
Newsletters (/newsletters/)	NewsArticle, CreativeWork	Mostly external redirects — does schema help here?
Products (/products/)	SoftwareApplication, WebApplication	Rich fields available: platforms, appStoreURL, githubRepoName
Services page (/services/)	Service, ProfessionalService	Three service offerings — individual or aggregate?
Index / About (/, /about-us/)	Organization, LocalBusiness	BrightDigit company identity
Individual article with FAQ section	FAQPage + Article	Can both be combined on one page?

Deliverables

• Confirmed schema type per section with rationale
• Flag any types that require new front matter fields vs. auto-derivable from existing ItemMetadata
• Note which types are supported by Google Rich Results (affects search appearance, not just AI)
• Identify any types where the content structure doesn't fit (e.g. HowTo needing discrete steps in long-form prose)
• Update Phase 1A implementation plan in PRD.md with confirmed types

Dependency

This issue must be resolved before:

• Implement FAQ Schema Markup in PiHTMLFactory #19 (FAQ Schema Markup)
• Implement HowTo Schema Markup in PiHTMLFactory #20 (HowTo Schema Markup)

Reference

• .claude/ai-cite-optimization/ — existing schema struct definitions (FAQSchema, HowToSchema, ArticleSchema)
• Sources/BrightDigitSite/BrightDigitSite.swift — ItemMetadata fields available for auto-generation