Where to Edit

Where to Edit

3 repos. Each owns specific content. This page = single source of truth for where to make changes.

Repos at a glance

Repo	Visibility	License	Owns
dalangHQ/dalang	PUBLIC	Apache-2.0	Rust engine, CLI, WIT, public docs, public marketing copy
dalangHQ/dalang-platform	PRIVATE	BSL-1.1	Hub SaaS, Cloud orchestrator, prod ops, BSL arch docs
dalangHQ/dalang-company	PRIVATE	Confidential	Handbook SSOT (public + private), fundraising, board, agent analysis

Decision tree

Want to change something?
├── Rust code (public engine, CLI, WIT)
│   → edit dalang/product/
├── Rust code (Hub API, BSL)
│   → edit dalang-platform/hub/api/
├── Architecture deep dive (public)
│   → edit dalang/content/architecture/<name>.md
├── Architecture doc (Hub or Cloud, BSL)
│   → edit dalang-platform/{hub,cloud}/docs/architecture/
├── Ops runbook (CI, releases)
│   → edit dalang/content/ops/<name>.md
├── Top-level doc (getting-started, cli, wit)
│   → edit dalang/content/<name>.md
├── Marketing copy
│   → edit dalang/content/marketing/copywriting/<name>.md
├── Handbook page (PUBLIC — values, comp, pricing, CLA)
│   → edit dalang-company/handbook/<subpath>/<name>.md
│   → CI auto-mirrors to dalang/content/handbook/ on merge
├── Handbook page (PRIVATE — fundraising, battlecards, board)
│   → edit dalang-company/handbook/<subpath>/<name>.md
│   → stays private, NOT mirrored
├── Prod ops (terraform, helm with secrets)
│   → edit dalang-platform/ops-private/
└── Internal analysis doc
    → edit dalang-company/agent/

Full content map

dalangHQ/dalang (public Apache)

Path	What	Renders on docs.dalang.dev?
product/crates/{dalang-core,dalang-edge,dalang-mesh,dalang-plugin}/	Rust crates	no (code)
product/cli/	Rust CLI binary	no (code)
product/wit/	WIT contracts	no (code)
product/sdk/	SDK stubs	no (code)
product/examples/	Example stubs	no (code)
content/architecture/*.md	6 architecture deep dives	yes, at /architecture/<name>/
content/ops/*.md	3 runbooks (releases, smart-ci, updating-handbook)	yes, at /ops/<name>/
content/handbook/**/*.md	MIRROR from dalang-company — DO NOT EDIT	yes, at /handbook/<subpath>/
content/marketing/copywriting/*.md	6 marketing copy files	no (source-only, no frontmatter)
content/getting-started.md	Onboarding guide	yes, at /getting-started/
content/cli.md	CLI reference	yes, at /cli/
content/wit.md	WIT contracts overview	yes, at /wit/
docs/src/	Astro code (components, pages, config)	n/a (renders the site)
ops/	Helm + Terraform template READMEs	no (templates)

dalangHQ/dalang-platform (private BSL)

Path	What	Renders on docs.dalang.dev?
hub/api/	Hub API Rust binary	no (code)
hub/storefront-ui/	Hub UI (Bun)	no (code)
hub/billing/	Billing stub	no
hub/crucible/	Crucible stub	no
hub/docs/architecture/dalang-hub.architecture.md	Hub arch deep dive (317 lines)	no (BSL private)
cloud/control-plane/	Control plane stub	no
cloud/federation/	Federation stub	no
cloud/docs/architecture/dalang-cloud.architecture.md	Cloud arch deep dive (100 lines)	no (BSL private)
ops-private/	Prod terraform + helm (with secrets)	no

dalangHQ/dalang-company (private, SSOT for handbook)

Path	What	Mirrored to dalang?
handbook/strategy/master-plan.md	Asset-light strategy	YES (public)
handbook/strategy/business-model-canvas.md	BMC	YES (public)
handbook/strategy/moat-analysis.md	Moat analysis	NO (private)
handbook/people/async-culture.md	Async guidelines	YES (public)
handbook/people/engineering-rubric.md	Hiring rubric	YES (public)
handbook/people/README.md	Comp/onboarding stub	NO (private)
handbook/gtm/devrel-calendar.md	DevRel calendar	YES (public)
handbook/gtm/trojan-horse-content.md	Content strategy	YES (public)
handbook/gtm/pql-dashboard.md	PQL metrics	NO (private)
handbook/sales/pricing.md	Public pricing matrix	YES (public)
handbook/sales/objection-handling.md	Sales objections	NO (private)
handbook/sales/battlecards/vs-cloudflare.md	Competitive intel	NO (private)
handbook/legal/BSL-LICENSE.md	BSL terms	YES (public)
handbook/legal/CLA.md	Contributor license agreement	YES (public)
handbook/legal/trademarks.md	Trademark list	YES (public)
handbook/fundraising/seed-deck-outline.md	Seed deck	NO (private)
handbook/fundraising/metrics-cohort.md	Cohort metrics	NO (private)
handbook/fundraising/data-room/README.md	Data room manifest	NO (private)
handbook/board/README.md	Board notes stub	NO (private)
agent/analysis/*.md	Internal review docs	NO (private)

Allowlist of public files mirrored: .handbook-public-allowlist in dalang-company repo.

Common tasks

I want to fix a typo on docs.dalang.dev

Find the URL on docs site, then map to source:

docs.dalang.dev URL	Source file to edit
/getting-started/	dalang/content/getting-started.md
/cli/	dalang/content/cli.md
/wit/	dalang/content/wit.md
/architecture/overview/	dalang/content/architecture/overview.md
/architecture/dalang/	dalang/content/architecture/dalang.md
/architecture/dalang-edge/	dalang/content/architecture/dalang-edge.md
/architecture/dalang-event/	dalang/content/architecture/dalang-event.md
/architecture/dalang-mesh/	dalang/content/architecture/dalang-mesh.md
/architecture/dalang-plugin/	dalang/content/architecture/dalang-plugin.md
/ops/releases/	dalang/content/ops/releases.md
/ops/smart-ci/	dalang/content/ops/smart-ci.md
/ops/updating-handbook/	dalang/content/ops/updating-handbook.md
/handbook/strategy/master-plan/	dalang-company/handbook/strategy/master-plan.md
/handbook/strategy/business-model-canvas/	dalang-company/handbook/strategy/business-model-canvas.md
/handbook/people/async-culture/	dalang-company/handbook/people/async-culture.md
/handbook/people/engineering-rubric/	dalang-company/handbook/people/engineering-rubric.md
/handbook/gtm/devrel-calendar/	dalang-company/handbook/gtm/devrel-calendar.md
/handbook/gtm/trojan-horse-content/	dalang-company/handbook/gtm/trojan-horse-content.md
/handbook/sales/pricing/	dalang-company/handbook/sales/pricing.md
/handbook/legal/BSL-LICENSE/	dalang-company/handbook/legal/BSL-LICENSE.md
/handbook/legal/CLA/	dalang-company/handbook/legal/CLA.md
/handbook/legal/trademarks/	`dalang-company/handbook/legal/trademarks.md

Edit link on each docs.dalang.dev page (top-right) points directly at correct source file on GitHub. Click it.

I want to add a new architecture deep dive

1. Create dalang/content/architecture/<name>.md
2. Add frontmatter (title, description, author, status, last_updated)
3. Sidebar auto-includes under “Architecture Deep Dives”
4. URL: docs.dalang.dev/architecture/<name>/

I want to add a new public handbook page

1. Create dalang-company/handbook/<subpath>/<name>.md
2. Add frontmatter (title, description, author, status, last_updated)
3. Add <subpath>/<name>.md to dalang-company/.handbook-public-allowlist
4. Commit + push to main
5. CI sync job copies to dalang/content/handbook/<subpath>/<name>.md
6. dalang auto-commits + pushes
7. Cloudflare Pages rebuilds
8. URL: docs.dalang.dev/handbook/<subpath>/<name>/

I want to add a new private handbook page (not on docs site)

1. Create dalang-company/handbook/<subpath>/<name>.md
2. Add frontmatter
3. DO NOT add to .handbook-public-allowlist
4. Commit + push to main
5. Stays private. Not mirrored. Not on docs.dalang.dev.

I want to change public pricing

Edit dalang-company/handbook/sales/pricing.md. CI auto-syncs to dalang/content/handbook/sales/pricing.md. docs.dalang.dev/handbook/sales/pricing/ updates.

I want to change Hub API code

Edit dalang-platform/hub/api/src/main.rs. Private BSL. Never appears on docs.dalang.dev.

I want to change dalang-core Rust code

Edit dalang/product/crates/dalang-core/src/lib.rs. Public Apache.

Golden rules

1. dalang/content/handbook/ = MIRROR. Never edit here. SSOT = dalang-company/handbook/. Edits here get overwritten by CI sync.
2. docs/src/ = Astro code only. Zero .md files. All content Markdown lives at content/ root.
3. Edit link on docs.dalang.dev = source of truth. Top-right of each page. Click it, lands on correct file in correct repo.
4. Public vs private handbook. Allowlist decides. Add file to .handbook-public-allowlist → public. Don’t add → private.
5. License boundary = physical. Apache code in dalang. BSL code in dalang-platform. Confidential docs in dalang-company. Never mix.

Questions?

Open issue on dalangHQ/dalang with question label. Or see CONTRIBUTING.md.