> For the complete documentation index, see [llms.txt](https://india-energy-stack.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://india-energy-stack.gitbook.io/docs/propose-a-schema.md).

# Propose a Schema

A proposal travels a fixed **\~4-week lifecycle** — from the form below to a published entry in the [schema catalogue](/docs/schemas/schemas-ies.md). Your submission opens a public GitHub issue, and that issue stays the single record for it through every stage. Include a **concept note** built on the use-case overview template — [read it on GitHub](https://github.com/India-Energy-Stack/ies-accelerator/blob/main/.github/templates/use-case-overview.md) or [download it as Word (.docx)](https://github.com/India-Energy-Stack/ies-accelerator/raw/main/.github/templates/use-case-overview.docx) — after the architecture review, the IES Cell turns it into the use-case write-up that goes for final sign-off.

```mermaid
flowchart LR
    A["<b>Proposal</b><br/>Day 0<br/>form or issue<br/>+ concept note"] -->|issue opened| B["<b>Open comments</b><br/>Weeks 1–2<br/>ecosystem review"]
    B -->|freeze v0.1| C["<b>Targeted review</b><br/>Week 3<br/>picked experts"]
    C -->|v0.2| D["<b>Architecture review</b><br/>Week 4<br/>IES specs &amp; conventions"]
    D -->|v0.3| E["<b>Use-case review</b><br/>Week 4<br/>IES Cell finalises;<br/>concept note → use case"]
    E -->|use case ready| F["<b>Final review</b><br/>Week 4<br/>CEA &amp; authorities"]
    F -->|approved| G["<b>Published</b><br/>IES Cell lists it"]
```

| When          | Stage                                                             | Output            |
| ------------- | ----------------------------------------------------------------- | ----------------- |
| Day 0         | Proposal — form below or a GitHub issue, **with a concept note**  | Proposal issue    |
| Weeks 1–2     | Open ecosystem comments                                           | **v0.1** (frozen) |
| Week 3        | Targeted review by picked experts (1-week deadline)               | **v0.2**          |
| Week 4        | Architecture review — IES specs, schema conventions               | **v0.3**          |
| Week 4        | IES Cell finalises the schema; concept note → **use-case review** | Use case          |
| Week 4        | CEA / authorities final review                                    | Approved          |
| End of Week 4 | IES Cell lists it in the schema catalogue                         | Published         |

Revising an existing schema follows the same flow: non-breaking changes (new optional fields or enum values) stay within the minor version; breaking changes get a new sibling version, and the old one stays reachable.

***

The IES ecosystem grows through community-proposed schemas. If you're working on a data model that a use case needs, propose it here — tell us who you are, which use case it supports (existing or new), the schema itself, and the standards it builds on.

{% hint style="warning" %}
**Read** [**Before You Propose**](/docs/propose-a-schema/before-you-propose.md) **first** (also as [Word .docx](https://github.com/India-Energy-Stack/ies-accelerator/raw/main/before-you-propose.docx)). It is a one-page checklist — taxonomy, naming, standards, one proposal per use case. Proposals that skip it are sent back before review starts.
{% endhint %}

Fill in the form below. Your contact details (email and mobile) are kept **private** — shared only with the IES secretariat. A public tracking issue is created automatically for the proposal itself (schema, use case, standards) so the community can review and discuss it. No GitHub account is required to submit.

{% hint style="info" %}
Optionally include your GitHub username and we'll tag you on the tracking issue so you can follow the discussion.
{% endhint %}

{% hint style="info" %}
Two references worth keeping open as you fill this in: the [IES term taxonomy](https://india-energy-stack.gitbook.io/docs/schemas/taxonomy) — check your terms align with it — and the use-case overview template ([GitHub](https://github.com/India-Energy-Stack/ies-accelerator/blob/main/.github/templates/use-case-overview.md) · [Word .docx](https://github.com/India-Energy-Stack/ies-accelerator/raw/main/.github/templates/use-case-overview.docx)) to structure your concept note. Share the concept note as a **public link** (a Google Doc set to "anyone with the link", or a GitHub link).
{% endhint %}

{% @ies-schema-proposal/schema-proposal content="" %}

If the form above doesn't load, [open it in a new tab](https://forms.gle/ESVk4PDcfEerPo6f7).

After submitting, your proposal is posted to the [GitHub Issue Tracker](https://github.com/India-Energy-Stack/ies-accelerator/issues) — you should see an issue populated with your request, where the community reviews and discusses it.

Not sure which use case yours fits? Browse the use-case overviews first, starting with [Consumer Energy Passport](/docs/use-case-overviews/consumer-energy-passport.md).