2017-05-01 6 views
7

Publikuję samouczek, który zawiera dużo kodu przeplatanego z dokumentacją. Zastanawiam dwa sposoby gospodarzem kod:Gist vs. Repozytorium dla Tutorial

  1. Oddzielna repozytorium git z plików kodu i plików przecen wyjaśniających kod
  2. Github Istota zawierający zarówno tych

Czy istnieją zalety w hostingu repozytorium gist v/sa? Kiedy jeden wolałby jeden z nich nad drugim?

Odpowiedz

10

Gist to prosty sposób udostępniania fragmentów i pasty innym osobom. Natomiast Repo to po prostu miejsce, w którym przechowywana jest historia Twojej pracy.

Nie ma dobrej odpowiedzi, to osobiste preferencje. Rozróżniam koncepcyjne rozróżnienie. Jeśli jest to kod zaprojektowany w celu zademonstrowania techniki, nauczyć zasady lub pochwalić się rozwiązaniem, które idzie w istotę. Nie ma znaczenia, czy jest to jeden plik, czy 30 plików. Jeśli jest to rzeczywisty kod, który ma być uruchamiany, używany jako taki lub rozwidlony jako zestaw standardowy, umieszczam go w odpowiednim repozytorium.

+4

"Nie ma znaczenia, czy jest to jeden plik, czy 30 plików" ... ale ma znaczenie, jeśli potrzebujesz podkatalogów. Gist nie obsługuje katalogów. –