Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[guide] CONTRIBUTING says data/projects-born.json has no validation script — validate:projects-born now exists and gates CI

Aperta Adatta ai principianti
  • Qualcosa non va?
#776 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
92/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
javascript
Ambito
documentation

Direzione di ricerca

Inizia in CONTRIBUTING.md, alla riga della tabella ProjectsBorn intorno alla riga 68 e nell’elenco delle regole intorno alla riga 102. Controlla scripts/validate-projects-born.mjs, package.json e .github/workflows/ci.yml per confermare il comando e il suo utilizzo in CI. Il lavoro è completato quando entrambe le affermazioni obsolete menzionano npm run validate:projects-born e la documentazione corrisponde al comportamento di validazione corrente del repository.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

agent/guide documentation hive/hosted-available-lke648397-260827-5n31

Documentation Gap

CONTRIBUTING.md's data contribution model is stale after PR #753 (merged in 10e70b5). It states twice that data/projects-born.json has no validation:

  • The table row (line 68): ProjectsBorn (/practitioners) | data/projects-born.json | manual edit, no validation script
  • The rules list (line 102): data/projects-born.json has no generator; edit it directly

But PR #753 added scripts/validate-projects-born.mjs (105 lines), the npm run validate:projects-born script, and a CI step in .github/workflows/ci.yml (line 61) that runs it on every PR. grep -r "validate:projects-born" --include="*.md" returns zero hits — no doc anywhere in the repo mentions the validator.

Impact

A contributor editing data/projects-born.json follows CONTRIBUTING, makes a manual edit with no local validation, and only learns the file has a strict machine-checked contract (URL allowlists, schema checks added by the security hardening in #753) when the "Validate repository" CI check fails on their PR. Every other data file in the same table documents its validator; this one now misleads.

Recommendation

  • Table row: change the Validation column for ProjectsBorn to npm run validate:projects-born
  • Rules bullet: keep "no generator; edit it directly" but append that the edit must pass npm run validate:projects-born (which CI enforces), matching the pattern used for the other curated files

Single small CONTRIBUTING.md edit; one PR closes this.

Filed by guide agent (ACMM L4 — issues-only mode)

🐝 Hive Agent: guide | Instance: hosted-available-lke648397-260827-5n31 | SHA: unknown

— hive: agent=guide backend=copilot model=kimi-k3 copilot=1.0.88

Lingua principale
JavaScript
Stelle
0
Fork
2
Merge medio
1g 9h
PR unite (30g)
232

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di cncf/endusers

Tutte le issue di cncf/endusers

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.