Gist Vs. Öğretici

Question

için Deposu Dokümantasyon ile serpiştirilmiş çok fazla kod içeren bir eğitici yayınlıyorum. içinde barındıran avantajlarını

Github özü bu

her iki içeren kod açıklayan kod dosyaları ve markdown dosyaları ile

1. Ayrı git depo var: Hiç kod barındıran iki yol düşünüyorum bir g/v deposu mu? Bunlardan biri diğerinden hangisini tercih ederdi?

Answer 1

Gist, parçacıkları ve macunları başkalarıyla paylaşmanın basit bir yoludur. Repo, işinizin geçmişinin saklandığı bir yer olduğu için.

İyi bir yanıt yok, kişisel tercih. Benimkini kavramsal bir ayrım yapıyorum. Bir tekniği göstermek için tasarlanmış bir kodsa, bir ilkeyi öğretin ya da bir çözümün içinde yer aldığı bir çözümü gösterin. Bir dosya mı yoksa 30 dosya mı olduğu önemli değil. Çalıştırılmak istenen asıl kod ise, olduğu gibi kullanılmışsa veya boilerplate olarak kullanılmışsa, onu uygun bir depoya koydum.