Voltage — Living docs for a living codebase

01Living docs

Your team shouldn't need an engineer to know what's true.

Voltage turns the parts of your repo your team cares about — event taxonomies, pricing logic, eligibility rules, API contracts — into living docs that rewrite themselves on every push to main, with every line cited back to source.

Acme/Data/Event taxonomy

Synced · 2m ago

ON THIS PAGE

Overview

Naming

Core events

Property contract

Identity

Versioning

Overview

Acme tracks 47 user-facing events — checkout_completed, signup_finished, feature_unlocked, and more. Every event carries the standard property contract plus a per-event payload, and names follow object_verb in past tense.

12 sources · analytics/events.ts + 11 more

last touched a06b3f1

Naming convention

Property keys are snake_case. No PII in property values. New events must reference an existing tracking plan in /events.ts.

Auto-published from mainv14212 subscribers

02Doc Changes

Shape what gets shipped — without writing code.

When a PR touches a doc you own, Voltage opens a Doc Change. Review the proposed prose, comment on what's wrong, approve when it's right — your feedback syncs straight to the GitHub PR so engineers see it without leaving their workflow.

Doc Change #1421Open

Add time_to_purchase_seconds to checkout_completed

Event taxonomy · Conversion events

Fires when a customer completes checkout. Properties: plan_id, variant_id, cart_total_usd.

Now also carries time_to_purchase_seconds — the seconds elapsed since checkout_started, enabling time-to-conversion funnel analysis.

Sarahjust now

We’ve been wanting this for funnel reporting. Approving.

Synced to PR #1421

03Notifications

Hear about the changes that matter to you. Nothing else.

Subscribe to the docs that intersect with your work. When something shifts, Voltage tells you in Slack, Teams, email, or in-app — threaded, batched, and never noisy.

Event taxonomy — code change proposed

PR #1421 by @jorgep adds time_to_purchase_seconds to checkout_completed.
Review change →

Delivered to #data-product · 12 subscribers

just now

Pricing rules · synced from main

3 sections regenerated from c8a91f3

Delivered to #revenue-ops · 8 subscribers

2h ago

Break the silos.Share the knowledge.

Overview

Built for everyone at your company
who doesn’t write the code,
but cares what it does.

Your team shouldn't need an engineer to know what's true.

Overview

Naming convention

Shape what gets shipped — without writing code.

Hear about the changes that matter to you. Nothing else.

Get everyone on the
same page.

Break the silos.Share the knowledge.

Overview

Built for everyone at your companywho doesn’t write the code,but cares what it does.

Your team shouldn't need an engineer to know what's true.

Overview

Naming convention

Shape what gets shipped — without writing code.

Hear about the changes that matter to you. Nothing else.

Get everyone on thesame page.

Built for everyone at your company
who doesn’t write the code,
but cares what it does.

Get everyone on the
same page.