Skip to main content

WDS Schema Reference

WDS.manifest.toml​

The standard manifest. Describes WDS itself: its identity, governance relationships, artifact locations, and lifecycle.

[standard]
id = "wds"
title = "Website Development Standard"
abbreviation = "WDS"
status = "active"
maturity = "candidate"
version = "0.2.1"
description = "Governs websites and web applications as documented, deployable, accessible, metadata-rich, monitorable projects."

[governance]
meta_standard = "SFDS"
workspace_standard = "WGS"
scope = "Websites, web applications, deployment records, accessibility, metadata, route checks, rollback expectations, and monitoring."
non_goals = ["Desktop installer releases", "CLI command output", "dataset corpus construction"]

[artifacts]
specification = "Website Development Standard.md"
schema = "SiteManifest.schema.toml"
templates = "templates"
examples = "examples"
adoption_guide = "Adoption-Guide.md"
validation_checklist = "Validation-Checklist.md"
changelog = "CHANGELOG.md"
validators = []
governance_notes = []
reference_examples = [
  "examples/WDS-Suite-Map.md",
  "examples/Example-Deployment-Record.md",
  "examples/Example-Accessibility-Metadata-Check.md"
]

[adopter_artifacts]
schemas = ["SiteManifest.schema.toml"]
manifest_templates = ["templates/Site-Manifest.toml"]
document_templates = ["templates/Deployment-Record.md"]

[lifecycle]
created = "2026-06-10"
last_updated = "2026-06-11"
maintainer = "Herb"

[agent]
read_first = ["README.md", "Website Development Standard.md", "WDS.manifest.toml"]
notes = "Expected adopters include aptlantis.net and aptlantis.studio."
  • [standard] — identity block: id, title, abbreviation, status, maturity, version, and a one-line description.
  • [governance] — links WDS to its meta-standard (SFDS) and the workspace standard (WGS), and states scope and explicit non-goals.
  • [artifacts] — points to the specification, schema, templates/examples folders, adoption guide, validation checklist, and changelog files that make up the suite.
  • [adopter_artifacts] — the subset of schemas/templates that adopting website projects actually consume (as opposed to suite-internal documents).
  • [lifecycle] — creation/update dates and maintainer.
  • [agent] — reading order and notes for automated agents onboarding onto the standard; names expected adopters (aptlantis.net, aptlantis.studio).

SiteManifest.schema.toml​

The schema that validates a project's Site-Manifest.toml.

title = "WDS Site Manifest Schema"
type = "object"
required = ["site", "governance", "deployment"]

[properties.site]
required = ["id", "title", "status"]

[properties.governance]
required = ["standard", "workspace_standard"]

[properties.deployment]
required = ["environments", "rollback"]

[properties.accessibility]
required = ["target", "checks"]

[properties.metadata]
required = ["title", "description", "canonical"]
  • site — required fields identifying the site (id, title, status).
  • governance — required links back to the governing standard and workspace standard.
  • deployment — required environment list and rollback expectation.
  • accessibility — required target level and checks performed.
  • metadata — required title, description, and canonical URL for SEO/sharing.