Dépôt du code source

Gestion des versions

Il est recommandé d’avoir une politique de gestion des versions de votre code source. Le guide la gestion sémantique de version propose un guide sur l’attribution et l’incrémentation des numéros de version.

Fichiers présents dans le dépôt

Assurez-vous d’avoir les fichiers suivants à la racine de votre dépôt:

Les fichiers suivants présentent également un intérêt:

Ces fichiers doivent être en format texte ou de préférence en format Markdown (on ajoute alors l’extension .md au nom du fichier). Il n’est pas recommandé d’utiliser des formats binaires (PDF ou autres).

Assurez-vous également que les fichiers du dépôt ne contiennent pas d’informations confidentielles (adresses de serveurs, mots de passe, etc.) ou de données nominatives.

Entête des fichiers sources

Chaque fichier de code source devrait indiquer son auteur et son identifiant de licence SPDX. Voici un exemple d’entête de fichier:

 /*
  * Copyright (c) 2018 Gouvernement du Québec
  *
  * SPDX-License-Identifier: LiLiQ-Rplus-1.1
  * License-Filename: LICENSES/LiLiQ-P11unicode.txt
  */

Ces suggestions sont inspirées des bonnes pratiques de modalités d’ouverture des codes sources de la DINSIC.