Online Services Knowledge Base¶

The Online Services Knowledge Base (OSKB) is the internal source of truth for documentation related to the website portfolio, infrastructure, deployments, development workflows, integrations, and operational processes maintained by Online Services.

This site is maintained in a private GitHub repository using Markdown and Material for MkDocs.

Purpose¶

OSKB exists to reduce undocumented institutional knowledge and make Online Services work easier to understand, maintain, support, and improve.

Every meaningful operational discovery should become searchable here.

Main Sections¶

Operations¶

How Online Services works, the portfolio it owns, and the standards used to preserve operational knowledge.

Websites¶

Site-specific documentation organized by NASPO, the Procurement Professionals Alliance, and UPPCC.

Development¶

Local development workflows, developer tooling, DDEV usage, project onboarding, and development standards.

Infrastructure¶

Server setup, hosting, DNS, Cloudflare, Tailscale, security hardening, and shared infrastructure practices.

Git & Deployments¶

GitHub repository setup, development workflow, deployment pipelines, and environment promotion.

Knowledge Base¶

How OSKB itself is organized, edited, reviewed, and published.

What Belongs Here¶

Good candidates for OSKB include:

Website inventory and site-specific configuration
Git and deployment workflows
Server, hosting, DNS, and Cloudflare documentation
API and synchronization behavior
Analytics, pixels, and third-party integrations
Vendor handoff information
Repeatable operational procedures
Troubleshooting notes and technical decisions

What Does Not Belong Here¶

Do not store secrets, credentials, private keys, access tokens, password reset links, or sensitive security details in this knowledge base.

When sensitive information needs to be referenced, document where it is managed rather than copying the sensitive value into the repository.