10 lines
810 B
Markdown
10 lines
810 B
Markdown
## 10. Bonnes pratiques pour Gitea
|
|
|
|
1. **Choisissez un nom clair** : `README.md`, `CONTRIBUTING.md`, `CHANGELOG.md` ou `docs/guide.md`.
|
|
2. **Structurez avec des titres** : un titre principal, puis des sections `##` et des sous-sections `###`.
|
|
3. **Précisez le langage des blocs de code** pour faciliter la lecture.
|
|
4. **Préférez les chemins relatifs** pour les fichiers et images du dépôt, lorsque c'est approprié.
|
|
5. **Vérifiez l'aperçu** avant de valider vos modifications.
|
|
6. **Testez les extensions** (HTML, notes de bas de page, maths, blocs repliables) sur votre propre instance.
|
|
7. **Ne mettez jamais de secrets** dans un dépôt : mots de passe, clés API, jetons ou données sensibles.
|
|
8. **Restez lisible en mode texte brut** : évitez les tableaux trop larges et les décorations excessives. |