Pulsa para ir al contenido principal

Bienvenidos y agradecemos todos los contribuyentes a Capgo.

Esta página sirve como un ayudante para que puedas empezar 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 el capacitor-updater Plugin.

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

Idiomas: Swift, JavaScript, Java

capgo

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

Comparte dónde deseas contribuir para arreglar 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

Administrador de versiones que impulsa la actualización de aplicaciones en CI/CD.

Idiomas: JavaScript

  • Lea el guía de estilo.

  • Pregunte por ayuda en la habitación de chat de la comunidad.

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

  • Cuando trabajas en una nueva característica, crea un problema y discute con otros contribuyentes antes 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 pases horas trabajando en un code que podría no ser aceptado.

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

Enviar una solicitud de extracción

Antes de enviar una solicitud de extracción a cualquiera de los repositorios, asegúrate de que lo siguiente se haya hecho:

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

Ejemplos de titulos de PR buenos:

  • fix(std/http): Solucionar condición de carrera en servidor
  • docs(console): Actualizar docstrings
  • feat(doc): Manejar re-exports anidadas

Ejemplos de titulos de PR malos:

  • fix #7123
  • actualizar docs
  • solucionar bugs

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

  • Asegurarse 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 pruebas - 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 APIs públicas y queremos hacer eso 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 JSDoc. Esta documentación se analiza y está disponible para el compilador de TypeScript, y por lo tanto es fácil proporcionar más adelante. Los bloques JSDoc vienen justo antes de la declaración a la que se aplican y se denotan con un /** antes de terminar con un */Por ejemplo:

export const FOO = "foo";
        

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