Skip to content

Document the live exact-SHA import path #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
KyleBrierley merged 1 commit into from
Jul 17, 2026
Merged

Document the live exact-SHA import path #3

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 13 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# TheTechStack — Public Stack Records

[![Validate public stack data](https://github.com/KyleBrierley/thetechstack-data/actions/workflows/validate.yml/badge.svg)](https://github.com/KyleBrierley/thetechstack-data/actions/workflows/validate.yml)

Structured, evidence-backed records of what companies actually run. This data powers
[thetechstack.com/stacks](https://www.thetechstack.com/stacks).

Expand All @@ -13,8 +15,10 @@ flowchart LR
A["Cited public evidence"] --> B["Structured stack record"]
B --> C["Schema and evidence checks"]
C --> D["Human review"]
D --> E["Public record"]
E --> F["TheTechStack site"]
D --> E["Approved public commit"]
E --> F["Exact-SHA import"]
F --> G["Private revalidation + build"]
G --> H["TheTechStack site"]
```

The private research and editorial system remains private. This repository exposes the
Expand All @@ -30,9 +34,9 @@ instead. See [CONTRIBUTING.md](CONTRIBUTING.md) for the evidence and review rule

Records verified by the company get a ✓ badge on the site.

> Publication status: corrections are reviewed here, but the automated public-to-site
> deployment path is still being completed. An accepted correction will not be treated
> as live until a maintainer confirms the site update.
> Publication status: after an approved change merges, the exact validated public commit
> is imported into the private site repository, validated again, built, and deployed.
> A maintainer still confirms the production result before treating a correction as live.

## Schema

Expand All @@ -42,7 +46,7 @@ categories to [`schema/categories.md`](schema/categories.md).
Run the same validation used in pull requests:

```bash
npm install
npm ci
npm run validate
```

Expand All @@ -58,6 +62,6 @@ npm run validate

Data and schema: [CC BY 4.0](LICENSE) — use them with attribution to TheTechStack.

The records and schema in this repository are the intended public source of truth. The
current site synchronization direction is being migrated so approved public corrections
cannot be overwritten by the private publishing system.
The records and schema in this repository are the public source of truth. The site imports
approved public commits by exact SHA, so private publishing work cannot overwrite accepted
public corrections.