Nous accueillons et apprécions toutes les contributions à Capgo.

Cette page sert de guide pour vous aider à commencer à contribuer.

Projets

Il existe de nombreux dépôts dans l'organisation Capgo qui font partie de Capgo.

Les dépôts ont des portées différentes, utilisent différents langages de programmation et ont des niveaux variables en matière de contributions.

Pour vous aider à décider quel dépôt pourrait être le meilleur pour commencer à contribuer (et/ou correspond à vos intérêts), voici une courte comparaison (<strong>les langages en gras constituent la majorité du code</strong>) : Capgo

capacitor-updater

Il s'agit du dépôt principal qui fournit le plugin capacitor-updater.

Vous souhaitez corriger un bug ou ajouter une nouvelle fonctionnalité à capacitor-updater ? C'est le dépôt auquel vous souhaitez contribuer.

Languages: Swift, JavaScript, Java

capgo

L'application web et les fonctions sans serveur qui constituent la plateforme cloud Capgo.

Voici où vous pouvez contribuer pour réparer le backend de Capgo.

Languages: TypeScript.

website

Interface pour la page web officielle de Deno: https://capgo.app/

Languages: TypeScript, HTML, CSS

docs

Documentation en Markdown qui alimente https://doc.capgo.app

Languages: Markdown

capacitor-standard-version

Gestionnaire de version qui alimente la CI/CD pour mettre à jour les applications.

Languages: JavaScript

Soumettre une pull request

Avant de soumettre une PR à l'un des dépôts, assurez-vous que les points suivants sont effectués :

  1. Donnez au PR un titre descriptif.

Exemples de bon titre de PR :

Exemples de mauvais titres de PR :

Soumettre une PR à Capgo

En plus de ce qui précède, assurez-vous que :

  1. npm run lint passe - cela vérifiera le code Rust et JavaScript pour détecter les erreurs et les fautes courantes en utilisant Swiftlint (pour Swift) et eslint (pour JavaScript et Java)

Documentation des API

Il est important de documenter toutes les API publiques et nous voulons le faire directement dans le code. Cela permet de garantir que le code et la documentation sont étroitement liés.

JavaScript et TypeScript

Toutes les API et les types exposés publiquement, le module capacitor-updater doit avoir une documentation JSDoc. Cette documentation est analysée et disponible pour le compilateur TypeScript, et donc facile à fournir en aval. Les blocs JSDoc apparaissent juste avant l'instruction à laquelle ils s'appliquent et sont indiqués par un /** au début avant de se terminer par un */. Par exemple :

export const FOO = "foo";
        

Trouver plus à : https://jsdoc.app/