You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- When changing validation scope, update the same path set in `validate.yml``paths` and `validate-patch.yml``paths-ignore`: the canonical sample catalog, `scripts/**`, `tests/**`, and both npm manifest files.
9
9
- Preserve the `validate-json-schema` and `test` job names in both validation workflows because the patch workflow supplies their stand-in results.
10
10
- Keep the Jest `test` job dependent on `validate-json-schema` in `.github/workflows/validate.yml`.
11
-
- In the translation handoff, preserve the staging step that collects localized files before opening the cross-repository pull request.
12
-
- Reference credentials through GitHub Actions secrets, following `.github/workflows/handover-translations.yml`; never inline credential values.
13
11
- Get explicit approval before changing triggers, required-check behavior, permissions, secrets, or cross-repository handoff destinations.
Copy file name to clipboardExpand all lines: AGENTS.md
-3Lines changed: 0 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,6 @@ This repository publishes content rather than running an application service. Va
22
22
23
23
> **WARNING:** Production publication and cross-repository handoff are destructive or externally visible operations. Always get explicit user approval before:
24
24
> - Running or changing the production publication behavior in `azure-pipelines/publishSamples.yml`.
25
-
> - Running or changing the translation handoff behavior in `.github/workflows/handover-translations.yml`.
26
25
> - Changing protected-branch, required-check, credential, or secret handling.
27
26
28
27
### Rules
@@ -35,8 +34,6 @@ This repository publishes content rather than running an application service. Va
35
34
36
35
## Secrets Management
37
36
38
-
GitHub Actions accesses credentials through repository secrets in `.github/workflows/handover-translations.yml`, including `API_TOKEN_GITHUB`, `ACTION_EMAIL`, and `ACTION_USERNAME`.
39
-
40
37
### Rules for AI Agents
41
38
42
39
- Never inline secrets, tokens, passwords, connection strings, certificate material, or secret values.
Copy file name to clipboardExpand all lines: repo-context.md
+4-12Lines changed: 4 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -73,8 +73,7 @@ The repository follows a content pipeline rather than an application service lay
73
73
2.`tests/samples.schema.json` and the Jest specifications under `tests/` validate the sample-query and permission content through `scripts/test-initiator.js`.
74
74
3.`.github/workflows/validate.yml` runs schema validation and the npm test suite for relevant pull requests and pushes.
75
75
4.`azure-pipelines/publishSamples.yml` packages sample-query and permission files and uploads them to Azure Blob Storage from `master`.
76
-
5.`.github/workflows/handover-translations.yml` copies translated `messages/GE_*` files to `microsoftgraph/microsoft-graph-explorer-v4` from the `dev` branch.
77
-
6. The DevX API and Graph Explorer consume the published content, as described in `README.md`.
76
+
5. The DevX API and Graph Explorer consume the published content, as described in `README.md`.
78
77
79
78
---
80
79
@@ -83,7 +82,7 @@ The repository follows a content pipeline rather than an application service lay
83
82
- The unsuffixed JSON file is the base content file, such as `GE.json`, `sample-queries.json`, or `permissions-descriptions.json`.
84
83
- Localized files append an underscore and locale code before `.json`, such as `_de-DE`, `_fr-FR`, or `_zh-CN`.
85
84
- Jest test files use the `.spec.js` suffix.
86
-
- GitHub workflow file names describe their action, such as `validate.yml`, `validate-patch.yml`, and `handover-translations.yml`.
85
+
- GitHub workflow file names describe their action, such as `validate.yml`and `validate-patch.yml`.
87
86
88
87
---
89
88
@@ -93,14 +92,14 @@ The repository follows a content pipeline rather than an application service lay
93
92
|--------|------|-----------|-------|
94
93
| Content catalogs | JSON documents |`sample-queries/sample-queries.json`, `permissions/permissions-descriptions.json`, `permissions/new/permissions.json`, `permissions/new/provisioningInfo.json`, `messages/GE.json`, `ge-tour/tour-steps.json`| Canonical and localized data consumed outside this repository. |
95
94
| Validation configuration | npm script and JSON Schema |`package.json`, `tests/samples.schema.json`, `scripts/test-initiator.js`|`npm run test` starts Jest; GitHub Actions separately validates the sample catalog against its schema. |
| Publication automation | Azure Pipelines YAML |`azure-pipelines/publishSamples.yml`| Packages sample-query and permission content and publishes it to Azure Blob Storage. |
98
97
| Branch governance | Repository policy YAML and CODEOWNERS |`.github/policies/microsoft-graph-devx-content-branch-protection.yml`, `.github/CODEOWNERS`| Protects `master` and `dev` and assigns repository-wide ownership. |
99
98
100
99
### Config Disambiguation
101
100
102
101
-`package.json` defines the local test command and development dependencies; `tests/samples.schema.json` defines the allowed shape of sample-query content.
103
-
- GitHub Actions validate pull requests and hand off translations; `azure-pipelines/publishSamples.yml` handles production artifact publication.
@@ -112,7 +111,6 @@ The repository follows a content pipeline rather than an application service lay
112
111
-`tests/permissions-descriptions.spec.js` - checks display-name formatting in the canonical permission descriptions.
113
112
-`.github/workflows/validate.yml` - CI entry point for schema and Jest validation.
114
113
-`azure-pipelines/publishSamples.yml` - production publication entry point for sample-query and permission files.
115
-
-`.github/workflows/handover-translations.yml` - translation handoff entry point for localized Graph Explorer messages.
116
114
117
115
---
118
116
@@ -135,12 +133,6 @@ The repository follows a content pipeline rather than an application service lay
135
133
| Azure Blob Storage | Receives published sample-query and permission artifacts from the production pipeline. | Not declared in this repository |
136
134
| Microsoft Graph documentation endpoints | Supply the `docLink` targets checked by the sample validation suite. | Not declared in this repository |
137
135
138
-
### Related Repositories
139
-
140
-
| Repo | Relationship | Purpose |
141
-
|------|-------------|---------|
142
-
|`microsoftgraph/microsoft-graph-explorer-v4`| Receives translated message files through `.github/workflows/handover-translations.yml`. | Hosts the Graph Explorer application that consumes the content. |
0 commit comments