> ## Documentation Index
> Fetch the complete documentation index at: https://uqp.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing

> Contribute synthetic examples, traceable pack rules and tests to the draft reference.

You can help shape **draft v0.1** by describing the questions your business asks, the pricing rules it uses and the points where a person must decide. Keep contributions **reference, not production**, and use synthetic examples instead of customer details.

## Start with a traceable change

Read the repository's `CONTRIBUTING.md`, `LICENSE`, `NOTICE` and `CLA.md` before proposing changes. The repository's spec text, schemas, packs and code use Apache-2.0. You must sign the Contributor License Agreement with 1G Media Inc. before a contribution can be accepted; the CLA is still a draft pending legal review, with signing instructions to follow once finalized.

You should also respect the UQP and Universal Quoting Protocol names held by 1G Media Inc.; the repository says a trademark policy will be published at version 1.0.

## Preserve pack and research boundaries

When you change a pack, map questions to factors, record provenance and assumptions, and add synthetic test cases for exceptions. Keep the [tattoo](https://uqp.dev/docs/packs/tattoo.md) and [laser-removal](https://uqp.dev/docs/packs/laser-removal.md) packs marked **unvalidated**. Label sample prices **example data**; implemented pricing rules are not evidence of market prices or clinical validity.

Review the [questionnaire harness](https://uqp.dev/docs/research/questionnaire-harness.md) and [evidence](https://uqp.dev/docs/research/evidence.md) before using research material. The harness is an offline, synthetic demonstration, not authorization to collect real pages. You must resolve the study's permission, sampling, retention and analysis gates before any future collection. Do not submit personal information, customer answers or private images as fixtures.

## Keep generated documentation in sync

Edit the source schema, binding, pack or research document rather than its generated MDX page. From the repository root, regenerate reference content before committing:

```sh theme={null}
npm run docs:sync
npm run docs:check
npm test
npm run typecheck
```

You can edit the introduction, quickstart, lifecycle and contributing pages directly. Keep internal links root-relative, give code fences a language tag and preserve the distinction between non-binding estimates and reviewed quotes. See the [lifecycle](https://uqp.dev/docs/lifecycle.md) before changing transition behavior.

## Keep the payment boundary explicit

You must preserve explicit client approval before checkout handoff, the provider's merchant-of-record role and trusted processor confirmation before marking a deposit paid. Do not imply that reference bindings implement production authentication, checkout processing or deployment.

## Join co-design

Use the [co-design form](https://uqp.dev/contribute/) to share your business requirements. Name, email, and industry (repo link and notes optional)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.