Saltar al contenido principal

Nosotros acogemos y apreciamos todas las contribuciones a Capgo.

Esta página sirve como un ayudante para que puedas empezar a contribuir.

Proyectos

Hay numerosos repositorios en el Capgo organización que forman parte del ecosistema de Capgo.

Los repositorios tienen diferentes alcances, utilizan diferentes idiomas de programación y tienen diferentes niveles de contribución.

Para ayudarte a decidir qué repositorio podría ser el mejor para empezar a contribuir (y/o que se ajuste a tus intereses), aquí tienes una comparativa breve (<strong> los idiomas en negrita comprenden la mayoría del código </strong>): Capgo

capacitor-updater

Este es el repositorio principal que proporciona el capacitor-updater Plugin.

Quieres corregir un bug o agregar una nueva característica a capacitor-updater? Este es el repositorio al que quieres contribuir.

Idiomas: Swift, JavaScript, Java

capgo

La aplicación web y las funciones serverless que componen la plataforma en la nube de Capgo.

Compartir dónde deseas contribuir para solucionar el backend de Capgo.

Idiomas: TypeScript.

website

Frontend para la página oficial de Deno: https://capgo.app/

Idiomas: TypeScript, HTML, CSS

docs

Documentación en Markdown que impulsa https://docs.capgo.app

Idiomas: Markdown

capacitor-standard-version

Version manager that power CI/CD to uppdate apps.

Idiomas: JavaScript

  • Lee el manual de estilo.

  • Pide ayuda en el salón de chat de la comunidad.

  • Cuando trabajes en un problema, menciona esto en los comentarios del problema. before Comienza a trabajar en el problema.

  • Cuando trabajas en una nueva característica, crea un problema y discute con otros contribuyentes. before Comienza a trabajar en la característica; apreciamos todos los aportes, pero no todos los características propuestas se aceptan. No queremos que pases horas trabajando en una code que podría no ser aceptada.

  • Por favor, sé profesional en los foros. Seguimos Rust's code of conduct (CoC). ¿Tienes un problema? Envía un correo electrónico tinyclouds.org.

Enviar una solicitud de extracción

Antes de enviar una solicitud de extracción a cualquier repositorio, asegúrese de que lo siguiente se haya realizado:

  1. Dale a la solicitud de extracción un título descriptivo.

Ejemplos de buen título de solicitud de extracción:

  • Corregir (std/http): Corregir condición de carrera en servidor
  • docs(console): Actualiza las documentaciones
  • feat(doc): Maneja las reexportaciones anidadas

Ejemplos de título de PR malo:

  • corregir #7123
  • update docs

  • corregir errores

  • Asegúrese de que exista un problema relacionado y se refiera en el texto del PR.

  • Asegúrese de que existan pruebas que cubran los cambios.

Enviar un PR a Capgo

Además de lo anterior, asegúrese de que:

  1. bun run lint pasa - esto verificará Rust y JavaScript code para comunes errores y errores utilizando Swiftlint para (Swift) y eslint (Para JavaScript y Java)

Documentación de APIs

Es importante documentar todas las API públicas y queremos hacerlo de manera inline con el code. Esto ayuda a asegurar que code y la documentación estén estrechamente acoplados.

JavaScript y TypeScript

Todas las API y tipos públicamente expuestos, el capacitor-updater El módulo debe tener documentación de JSDoc. Esta documentación se analiza y está disponible para el compilador de TypeScript, y por lo tanto es fácil proporcionarla más adelante. Los bloques de JSDoc vienen justo antes de la declaración a la que se aplican y están denotados por una línea que comienza con /** antes de terminar con un */. Por ejemplo:

export const FOO = "foo";

Encuentra más en: https://jsdoc.app/