Ajout de ressources de support à votre projet

Vous pouvez créer un fichier SUPPORT pour expliquer aux utilisateurs comment obtenir de l’aide sur votre projet.

Pour diriger les utilisateurs vers des ressources de support spécifiques, vous pouvez ajouter un fichier SUPPORT à la racine, au dossier docs ou au dossier .github de votre dépôt. Quand une personne crée un problème dans votre dépôt, elle voit un lien vers le fichier SUPPORT de votre projet.

Capture d’écran du formulaire d’un nouveau problème. Dans la barre latérale droite, dans la section « Ressources utiles », un lien intitulé « Support » est encadré en orange foncé.

Vous pouvez créer des ressources de support par défaut pour votre organisation ou votre compte personnel. Pour plus d’informations, consultez « Création d’un fichier d’intégrité de la communauté par défaut ».

Tip

Pour aider les utilisateurs à trouver les recommandations de support, vous pouvez créer un lien vers votre fichier SUPPORT à partir d’autres emplacements dans le référentiel, par exemple le fichier LISEZMOI.

Ajout de ressources de support à votre projet

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Au-dessus de la liste de fichiers, sélectionnez le menu déroulant Ajouter un fichier , puis cliquez sur Créer un fichier.

    Vous pouvez également cliquer sur dans l’arborescence de fichiers à gauche.

    Capture d’écran de la page principale d’un référentiel. Au-dessus de la liste des fichiers, un bouton, intitulé « Ajouter un fichier », est indiqué en orange foncé. Dans l’arborescence de fichiers du référentiel, un bouton, avec une icône du signe plus, est également encadré en orange foncé.

  3. Dans le champ du nom de fichier, tapez SUPPORT.md (tout en majuscules).

  4. Sous l’onglet Modifier le nouveau fichier, ajoutez des informations sur la façon dont les utilisateurs peuvent obtenir un support pour votre projet.

  5. Pour passer en revue votre fichier SUPPORT, cliquez sur Aperçu.

  6. Cliquez sur Valider les modifications...

  7. Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Création d’une validation avec plusieurs auteurs ».

  8. Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « Création d’une demande de tirage ».

    Capture d’écran d’une demande de tirage GitHub montrant une case d’option permettant de commiter directement dans la branche main ou de créer une branche. Une nouvelle branche est sélectionnée.

  9. Cliquez sur Valider les modifications ou Proposer des modifications.