Skip to content

CONTRIBUTING.es.md

Latest commit

 

History

History
57 lines (39 loc) · 1.47 KB

CONTRIBUTING.es.md

File metadata and controls

57 lines (39 loc) · 1.47 KB
Raw

Contribuir a ⋞Galactic-Shrine⋟ GsId

Gracias por su interés en contribuir a GsId.

GsId es un sistema de identificadores de 256 bits mantenido por ⋞Galactic-Shrine⋟, con implementaciones sincronizadas en C# y PHP.

Requisitos de desarrollo

C#

  • .NET SDK 8.0 o superior
  • Ejecute las pruebas desde la raíz del repositorio:
dotnet test csharp/GalacticShrine.GsId.sln

PHP

  • PHP 8.3 o superior
  • Composer 2
  • Ejecute las pruebas desde el directorio php:
cd php
composer install
composer test

Reglas de contribución

  • Mantener sincronizado el comportamiento entre las implementaciones de C# y PHP.
  • No modificar los formatos oficiales N y D sin una decisión de versión mayor.
  • Mantener un almacenamiento en base de datos determinista: preferir el formato N y una capitalización fija por aplicación.
  • Añadir o actualizar pruebas para cada cambio de comportamiento.
  • Mantener la compatibilidad retroactiva de las API públicas durante la serie 1.x siempre que sea posible.

Versionado

GsId sigue el versionado semántico:

  • MAJOR: cambios incompatibles en la API o en el formato.
  • MINOR: funcionalidades retrocompatibles.
  • PATCH: correcciones, CI, documentación, empaquetado y actualizaciones de mantenimiento.

Pull requests

Antes de abrir una pull request, asegúrese de que:

dotnet test csharp/GalacticShrine.GsId.sln
cd php
composer validate --strict
composer test

se ejecuten correctamente.