Module

health.validators.connectivity

Connectivity validator for knowledge graph analysis.

Validates site connectivity using semantic link model and connectivity levels, identifies isolated pages, and provides insights for better content structure.

Uses weighted scoring based on link types:

  • EXPLICIT: Human-authored markdown links (weight: 1.0)
  • MENU: Navigation menu items (weight: 10.0)
  • TAXONOMY: Shared tags/categories (weight: 1.0)
  • RELATED: Algorithm-computed related posts (weight: 0.75)
  • TOPICAL: Section hierarchy parent → child (weight: 0.5)
  • SEQUENTIAL: Next/prev navigation (weight: 0.25)

Connectivity Levels:

  • WELL_CONNECTED: Score >= 2.0 (no action needed)
  • ADEQUATELY_LINKED: Score 1.0-2.0 (could improve)
  • LIGHTLY_LINKED: Score 0.25-1.0 (should improve)
  • ISOLATED: Score < 0.25 (needs attention)
View source
1 Class

Classes

ConnectivityValidator
Validates site connectivity using semantic link model and knowledge graph analysis. Checks: - Isol…
1

Validates site connectivity using semantic link model and knowledge graph analysis.

Checks:

  • Isolated pages (weighted score < 0.25)
  • Lightly linked pages (score 0.25-1.0, only structural links)
  • Over-connected hubs (too many incoming references)
  • Overall connectivity health (average weighted score)
  • Content discovery issues

Uses weighted scoring based on link types (explicit, menu, taxonomy, etc.) to provide nuanced analysis beyond binary orphan detection.

This helps writers improve SEO, content discoverability, and site structure.

Inherits from BaseValidator

Methods 1

validate
Validate site connectivity.
2 list[CheckResult] 
def validate(self, site: Site, build_context: BuildContext | Any | None = None) -> list[CheckResult]

Validate site connectivity.

Parameters 2
site Site

The Site object being validated
build_context BuildContext | Any | None

Optional BuildContext with cached knowledge graph
Returns

list[CheckResult] —

List of CheckResult objects with connectivity issues and recommendations