Nos complace 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 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 error o agregar una nueva característica a capacitor-updater? Este es el repositorio al que deseas contribuir.
Lenguajes: Swift, JavaScript, Java
capgo
La plataforma de nube Capgo compuesta por la aplicación web y funciones sin servidor.
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 CI/CD para actualizar aplicaciones.
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 de
-
iniciar a trabajar en el problema. Cuando trabajas en una nueva característica, crea un problema y discute con otros contribuyentes. you start working on the feature; we appreciate all contributions, but not all proposed features are getting accepted. We don't want you to spend hours working on a code that might not be accepted.
-
de iniciar 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 el código de conducta de Rust
(CoC). Tienes un problema? Envía un correo electrónico a
ry@tinyclouds.org.
- Enviar una solicitud de extracción (pull request) en español es enviar una solicitud de extracción (pull request)."Solicitud de extracción (pull request) antes de enviar una solicitud de extracción (pull request) a cualquier repositorio, asegúrate de que se haya hecho lo siguiente: "Darle a la solicitud de extracción (pull request) 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 exportaciones 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 lintpasará - esto verificará Rust y JavaScript code para comunes errores y errores usandoSwiftlint(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/