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:
- 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:
bun run lintpruebas - esto verificará Rust y JavaScript code para comunes errores y errores utilizandoSwiftlint(para Swift) yeslint(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/