Saltar al contenido principal

Bienvenidos y agradecidos por todas las contribuciones a Capgo.

Esta página sirve como ayuda para que comiences a contribuir.

Proyectos

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

Los repositorios tienen diferentes alcances, utilizan diferentes lenguajes de programación y tienen diferentes niveles cuando se trata de contribuciones.

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 comparación breve (<strong> los lenguajes en negrita comprenden la mayoría del código base </strong>): Capgo

capacitor-updater

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

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

Idiomas: Swift, JavaScript, Java

capgo

La plataforma de nube Capgo formada por la aplicación web y funciones sin servidor.

Comparta dónde quiere contribuir para corregir el backend de Capgo.

Idiomas: TypeScript.

website

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

Idiomas: TipoScript, HTML, CSS

docs

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

Idiomas: Markdown

capacitor-standard-version

Administrador de versiones que impulsa CI/CD para actualizar aplicaciones.

Idiomas: JavaScript

  • Lee el Guía de estilo.

  • Pida ayuda en la habitación de chat de la comunidad.

  • Cuando trabaje en un problema, mencione eso en los comentarios del problema antes de empezar a trabajar en el problema.

  • Cuando trabaje en una nueva característica, cree un problema y discuta con otros contribuyentes antes de empezar a trabajar en la característica; apreciamos todos los contribuyentes, pero no todas las características propuestas se aceptan. No queremos que usted pase horas trabajando en un code que podría no ser aceptado.

  • Por favor, sea profesional en los foros. Seguimos Rust's code of conduct (CoC). Tiene un problema? Envíe un correo electrónico soporte@capgo.com.

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. Déle a la solicitud de extracción un título descriptivo.

Ejemplos de titulares de solicitud de extracción buenos:

  • fix(std/http): Solución de condición de carrera en el servidor
  • docs(console): Actualización de las documentaciones
  • feat(doc): Manejo de exportaciones anidadas

Ejemplos de titulares de solicitud de extracción malos:

  • fix #7123
  • actualizar documentación
  • solución de errores

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

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

Enviar una PR a Capgo

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

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

Documentar APIs

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

JavaScript y TypeScript

Todas las APIs y tipos expuestos públicamente, el capacitor-updater módulo debería tener documentación de JSDoc. Esta documentación se analiza y está disponible para el compilador de TypeScript, y por lo tanto fácil de proporcionar en línea. Los bloques de JSDoc vienen justo antes de la declaración a la que se aplican y se denotan con un líder /** antes de terminar con un */. Por ejemplo:

export const FOO = "foo";
        

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