Gist Vs. Référentiel pour le didacticiel
Je publie un tutoriel qui comprend beaucoup de code entrecoupé de documentation. J'envisage deux façons d'héberger le code:
- Dépôt git séparé avec des fichiers de code et des fichiers de démarque expliquant le code
- Github Gist contenant les deux
Y a-t-il des avantages à héberger dans un référentiel Gist v/s? Quand préférerait-on l'un de ces éléments à l'autre?
Gist est un moyen simple de partager des extraits et des pâtes avec d'autres. Tandis que Repo est simplement un endroit où est stocké l'historique de votre travail.
Il n'y a pas de bonne réponse, c'est une préférence personnelle. Je fais du mien une distinction conceptuelle. Si c'est du code conçu pour démontrer une technique, enseigner un principe ou montrer une solution, il va dans un Gist. Peu importe qu'il s'agisse d'un fichier ou de 30 fichiers. Si c'est du code réel destiné à être exécuté, utilisé tel quel ou fourchu comme passe-partout, je le mets dans un référentiel approprié.