Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

API Versioning

Abierto
#4 2 comentarios 1 reacción 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
30/100
Tipo de issue
Documentación
Claridad
Necesita aclaración
Estado de actividad
Estancado

Línea de trabajo

Empieza revisando la sección sobre versionado de las directrices de la API y compara sus recomendaciones con las prácticas de release descritas aquí. Revisa los dos comentarios existentes para obtener contexto y busca un acuerdo sobre si las directrices deberían cambiar; se considera terminado cuando el proyecto tenga una postura aceptada y actualizada sobre el versionado de la API.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

feedback

Let me first off say, thank you for doing this collaboratively and for all the work that has gone into this.

I do find the versioning section to be very prescriptive. Versioning is hard. Our project currently releases every day and usually has API changes on every release. Not breaking changes, but usually small additions. We're starting to get third-party consumers and will version when we introduce a breaking change.

I feel versioning at this fidelity forces an event driven architecture which is an unneeded complexity for many applications.

Feel free to hit me up in the lab if you'd like to discuss more.

Lenguaje dominante
Sin datos de lenguaje
Estrellas
34
Forks
10
Métricas de merge de PR
Sin PR fusionados en 30 d

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de bcgov/api-guidelines

Todos los issues de bcgov/api-guidelines

Issues similares

Más issues de Backend & API Design

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.