Skip to content

Commit cd682e6

Browse files
deblasiscursoragent
andcommitted
docs: align ai-draft Note wording and style guide
Single ai-draft state: AI translation with maintainer supervision; community review still welcome. Update Note on all nine stack pages. Signed-off-by: Alessandro De Blasis <alex@deblasis.net> Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 6eb7e2f commit cd682e6

10 files changed

Lines changed: 38 additions & 14 deletions

‎STYLE_GUIDE.md‎

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -166,23 +166,47 @@ Altri campi (`description`, ecc.) vanno tradotti se presenti.
166166

167167
## Traduzioni assistite (AI)
168168

169-
Pagine tradotte automaticamente in attesa di revisione umana devono includere:
169+
`ai-draft` indica una pagina **tradotta con AI e supervisionata da un maintainer** (un solo passaggio umano sul processo). Non è una traduzione umana da zero né un’approvazione definitiva della community.
170+
171+
| Campo | Ruolo |
172+
| ----- | ----- |
173+
| `translationStatus: ai-draft` | Metadato workflow (il sito oggi **non** lo legge) |
174+
| `<Note>` | Disclaimer visibile per i lettori |
175+
176+
Usa **sempre entrambi** sulle pagine AI. Il valore `ai-draft` **non cambia** tra PR aperta, merge e pagina live: merge ≠ revisione community.
170177

171178
```yaml
179+
---
180+
title: Titolo della pagina
172181
translationStatus: ai-draft
182+
---
173183
```
174184

175-
E subito dopo il frontmatter:
176-
177185
```mdx
178186
<Note>
179187

180-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/...).
188+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/PERCORSO/ESATTO.md).
181189

182190
</Note>
183191
```
184192

185-
Rimuovi `translationStatus` e il blocco `<Note>` quando la pagina viene revisionata e approvata.
193+
- **Non** rimuovere `translationStatus` né `<Note>` quando mergi lo stack AI dopo la tua revisione.
194+
- **Non** segnare `[x] (@maintainer)` su [#418](https://github.com/reactjs/it.react.dev/issues/418): non sei il traduttore umano, hai supervisionato l’output AI.
195+
- Su [#418](https://github.com/reactjs/it.react.dev/issues/418) la voce resta `[~] (AI draft) #NNN` anche dopo il merge.
196+
197+
Rimuovi `translationStatus` e `<Note>` **solo** se un contributor fa un passaggio editoriale completo (terminologia, tono, fraseggio) — allora `[~]` → `[x] (@reviewer) #NNN` con l’username di chi ha revisionato.
198+
199+
### Traduzione umana da zero
200+
201+
Nessun `translationStatus`, nessun `<Note>` AI. Su merge: `[x] (@translator) #NNN`.
202+
203+
### Issue #418 — checklist
204+
205+
| Evento | Voce checklist |
206+
| ------ | -------------- |
207+
| Apri PR AI | `[~] (AI draft) #NNN` |
208+
| Merge PR AI (supervisione maintainer) | **resta** `[~] (AI draft) #NNN` |
209+
| Revisione editoriale community | `[x] (@reviewer) #NNN` — rimuovi marker dal MDX |
186210

187211
---
188212

‎src/content/learn/lifecycle-of-reactive-effects.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ translationStatus: ai-draft
55

66
<Note>
77

8-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/lifecycle-of-reactive-effects.md).
8+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/lifecycle-of-reactive-effects.md).
99

1010
</Note>
1111

‎src/content/learn/manipulating-the-dom-with-refs.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ translationStatus: ai-draft
55

66
<Note>
77

8-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/manipulating-the-dom-with-refs.md).
8+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/manipulating-the-dom-with-refs.md).
99

1010
</Note>
1111

‎src/content/learn/queueing-a-series-of-state-updates.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ translationStatus: ai-draft
55

66
<Note>
77

8-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/queueing-a-series-of-state-updates.md).
8+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/queueing-a-series-of-state-updates.md).
99

1010
</Note>
1111

‎src/content/learn/reacting-to-input-with-state.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ translationStatus: ai-draft
55

66
<Note>
77

8-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/reacting-to-input-with-state.md).
8+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/reacting-to-input-with-state.md).
99

1010
</Note>
1111

‎src/content/learn/referencing-values-with-refs.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ translationStatus: ai-draft
55

66
<Note>
77

8-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/referencing-values-with-refs.md).
8+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/referencing-values-with-refs.md).
99

1010
</Note>
1111

‎src/content/learn/removing-effect-dependencies.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ translationStatus: ai-draft
55

66
<Note>
77

8-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/removing-effect-dependencies.md).
8+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/removing-effect-dependencies.md).
99

1010
</Note>
1111

‎src/content/learn/reusing-logic-with-custom-hooks.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ translationStatus: ai-draft
55

66
<Note>
77

8-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/reusing-logic-with-custom-hooks.md).
8+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/reusing-logic-with-custom-hooks.md).
99

1010
</Note>
1111

‎src/content/learn/separating-events-from-effects.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ translationStatus: ai-draft
55

66
<Note>
77

8-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/separating-events-from-effects.md).
8+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/separating-events-from-effects.md).
99

1010
</Note>
1111

‎src/content/learn/synchronizing-with-effects.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ translationStatus: ai-draft
55

66
<Note>
77

8-
Questa pagina è stata tradotta automaticamente e potrebbe beneficiare di una revisione umana. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/synchronizing-with-effects.md).
8+
Questa pagina è stata tradotta automaticamente e supervisionata da un maintainer. Un'ulteriore revisione da parte della community sarebbe comunque utile. [Migliora questa traduzione](https://github.com/reactjs/it.react.dev/edit/main/src/content/learn/synchronizing-with-effects.md).
99

1010
</Note>
1111

0 commit comments

Comments
 (0)