Skip to content

Repository files navigation

core

A repo to manage CivicTechWR.

It is an Obsidian vault, and 01 - Evergreen is published as the docs site. Drafts are branches, not folders: write on a branch, open a PR, and merging to main publishes. Open the repo root as a vault; the shared configuration is committed in .obsidian/.

Docs site

civictechwr.github.io/core — where CivicTechWR keeps its operating knowledge, what state each surface is in, and which surface owns which facts.

Built with Quartz from 01 - Evergreen/ and deployed to GitHub Pages by .github/workflows/deploy-site.yml on every merge to main. Edit the markdown and open a PR.

The GitHub Wiki that previously held these pages has been retired; it now holds a single page pointing here.

Page What it answers
Documentation Surfaces Where our docs live, and which are actually current
Process Index Every process we run, and where each one is defined
Process Modelling What a written-down process should look like
Drift Findings What is out of date, contradictory, or duplicated
Marketing Tooling we have, what needs building, where the risk is
Marketing Practices What we actually publish, and what performs
Ownership Model Which surface owns which fact
Remediation Checklist What we're fixing, in what order
Editing These Docs How to change pages and how publishing works

Layout

01 - Evergreen/      the register — published as the docs site (index.md is the landing page)
02 - Attachments/    data snapshots, exports, PDFs that notes point at; not notes
03 - Templates/      the note template (unique.md)
site/                Quartz config for the site build, and the retired wiki's stub page
.obsidian/           vault configuration, committed so the format is shared
.github/workflows/deploy-site.yml    builds 01 - Evergreen/ with Quartz, deploys to Pages
.github/workflows/retire-wiki.yml    one-shot, manual: points the old wiki at the site

Every note carries the frontmatter block from 03 - Templates/unique.mddate, status (draft · current · archived), tags, references — plus a title on published pages. Files in 02 - Attachments/ are not notes and carry none.

Everything in 01 - Evergreen/ on main is published, so [[wiki-links]] must point at another page in that folder. Images and files in 02 - Attachments/ are not published: embed one and it renders in Obsidian but is missing on the site.

About

A repo to manage CivicTechWR

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors