Microsoft JSON Schemas

For minor changes (a few lines), you can bypass the staging process and work directly with the Main and Live branches:

1. Create a GitHub branch and modify the existing schema file.
2. Open a PR and tag your team's other Admin as a reviewer.
3. Merge the PR into the Main branch.
4. After verifying the merge to Main, open a new PR to merge Main into Live.

Note: Updates generally occur within 30 minutes but can take up to 24 hours. You may need to clear your cache to see the changes.

Follow these steps to add a new schema to the repository:

1. Folder Structure: Create one folder per team. Keep the structure as flat as possible. The folder path determines the URL structure (e.g., https://developer.microsoft.com/json-schemas/folder/schema_name.json).
2. Staging: Create a working branch in GitHub, add your schema file, and open a Pull Request (PR) to merge into the Main branch. After merging, changes appear on staging servers within 2-15 minutes.
3. Production: After review, open a PR to merge the Main branch into the Live branch. Once approved and merged, the schema goes live in approximately 2-15 minutes.

To publish schemas to the centralized repository, your team must have Administrator permissions.

1. Select two Full-Time Employee (FTE) team members to act as Admins.
2. Submit a request for Admin permission to the @Microsoft/json-schemas-admins team.
3. Tag @VesaJuvonen in your request.

Once approved, Admins can create folders, add schemas, and manage pull requests. It is recommended to also request permissions for your documentation team, PMs, or EMs.

If a new schema does not appear automatically, you must manually publish it by copying it to the corresponding Azure storage repository.

1. Locate your team's folder in the Azure storage.
2. Create a new version folder (follow the pattern of existing schemas).
3. Copy your new schema into that folder.

Important for new root folders: If you create a new root-level folder, you must email devappportaleng@microsoft.com to request that they "allowlist" your folder. This allows the system to remove the locale from the full URL. Sub-folders do not require this step.