Governança

OSIRIS JSON és un Open Standard pensat per poder-se revisar obertament i ser impulsat per la comunitat.
Aquesta pàgina explica com es proposen, revisen i publiquen els canvis.

[!Info] Model actual de manteniment OSIRIS JSON actualment és mantingut per una sola lead maintainer. Les contribucions són benvingudes des del principi, però el procés és intencionadament lleuger per mantenir v1.0 gestionable i coherent.

Rols

Maintainer

És responsable de la qualitat i coherència del text de l'especificació, schemas, producers, exemples i notes de llançament. Assegura que els canvis preservin la vendor-neutrality, la claredat i les expectatives de compatibilitat.

Contributor

Proposa millores mitjançant issues i pull requests: correccions, aclariments, exemples nous, producers nous i guia d'implementació.

Reviewer

Membres de la comunitat que aporten criteri tècnic, revisió i feedback. La revisió és especialment valuosa per a canvis normatius i impactes de versionament.

On es prenen les decisions

GitHub discussions: discussions de disseny, preguntes i feedback inicial.
GitHub issues: bugs, inconsistències i propostes per canviar l’especificació.
Pull requests: el lloc autoritatiu on es canvien i es revisen el text, els schemas i els exemples.

Principis de presa de decisions

OSIRIS JSON segueix els principis de disseny de l’especificació amb un enfocament en:

Simplicitat
Neutralitat respecte als vendors
Extensibilitat sense fragmentació
Explícit per sobre d’implícit
Estabilitat i compatibilitat

El model de decisió per defecte és el rough consensus mitjançant discussió pública i revisió. Quan no es pot arribar a un consens, la lead maintainer pren una decisió i documenta la justificació al PR o issue.

Procés de canvi

Discutir

Obrir un issue (o discussion) descrivint el problema i el canvi previst

Implementar

Enviar un PR que actualitzi el text de la spec i, quan sigui aplicable, schemas/examples

Revisar

Revisar la correcció, la coherència i l'impacte en la compatibilitat

Merge & release

Els canvis fusionats es publiquen segons SemVer i les regles de deprecació

Tipus de canvis

Editorial (no normatiu)

Corregir typos, millorar la claredat, reestructurar seccions, millorar exemples sense canviar requisits.

Normatiu

Canvis que alteren requisits o interpretació (regles MUST/SHOULD/MAY), comportament de validació o expectatives de compatibilitat. OSIRIS JSON utilitza el format JSON àmpliament suportat i s’alinea amb convencions establertes, incloent-hi JSON Schema per a la validació estructural i les paraules clau de RFC 2119 per als requisits normatius.

Taxonomia / registry / guia d’extensions

Actualitzacions que afecten la interpretació de tipus estàndard, namespaces recomanats o millors pràctiques d’extensions.

Versionament, compatibilitat i releases

OSIRIS JSON utilitza Semantic versioning 2.0.0 per als releases de l’especificació.
El camp version d’un document OSIRIS JSON declara a quina versió de l’especificació s’ajusta i s’espera que producers/consumers segueixin el comportament de compatibilitat descrit a la spec.

Versions draft i pre-release

Durant el desenvolupament, les versions MAY utilitzen la notació SemVer de pre-release (per exemple, 1.0.0-DRAFT). Les versions draft/pre-release no es consideren estables i poden canviar de manera incompatible fins que es publiqui un release estable.

Política de deprecació

Les features deprecated segueixen un cicle de vida definit: anunci, documentació + guia de migració, període de transició (com a mínim un cicle MINOR) i eliminació només al següent release MAJOR.

Governança d’extensions

OSIRIS JSON defineix les namespace rules i, quan és aplicable, la política de registry per a prefixos de extension namespace ben coneguts, però no governa la semàntica interna de les extensions de vendor/organització. Els consumers han de tractar els valors dins de les extensions com a opacs, llevat que donin suport explícitament a aquell namespace.

Registre de namespaces (v1.0)

Per a OSIRIS JSON v1.0, el registre de namespaces és informal i impulsat per la comunitat:

Documentar públicament l’ús del namespace
Publicar extension schemas com a referència per al consumer (quan sigui aplicable)
Coordinar-se amb la comunitat d’OSIRIS JSON per evitar col·lisions

Namespaces recomanats

Organization namespaces haurien d’utilitzar patrons reverse-domain (per exemple, osiris.com.<org>) per reduir col·lisions.
osiris.custom.* es pot utilitzar per a experiments de curta durada i drafts de la comunitat, però no és resistent a col·lisions. Els producers haurien de migrar a organization namespaces per a ús persistent/de producció.

Codi de conducta

La participació a la comunitat d’OSIRIS JSON es regeix pel Code of Conduct.
Read the Code of Conduct