Bir projenin ilk önce kaynak kontrolünü üstlenmeye yetecek kadar uzakta olduğundan asla emin değilim. Proje “çerçeve tamamlanana” kadar taahhütte bulunma eğilimindeyim ve öncelikli olarak bundan sonra özellikler taahhüt ediyorum. (Bunun için çok büyük bir çekirdek çerçeveye sahip olacak kadar büyük kişisel projeler yapmadım.) Bunun neyin yanlış gidebileceğinden emin olmasam da, bunun en iyi uygulama olmadığını hissediyorum.

Örneğin, tek bir kod dosyasından oluşan bir projem var diyelim. Projenin son derece temel işlevsellik (1 veya 2 özellik) ile çalışmasını sağlamak için yaklaşık 10 satır boyler kod kodu ve 100 satır alacaktır. İlk önce check-in yapmalı mıyım:

1. Boş dosya?
2. Kazan kodu?
3. İlk özellikler?
4. Başka bir noktada mı?

Ayrıca, belirli bir noktada check-in yaptırmanın nedenleri nelerdir?

Mantıklı bir "ünite" hazırladığın anda tamamlamalısın.

Birim nedir? Bu ne yaptığınıza bağlıdır; Örneğin, bir Visual Studio projesi oluşturuyorsanız, içinde herhangi bir şey olmasa bile, oluşturulduktan hemen sonra çözümü yapın.

Oradan mümkün olduğunca sık taahhüt sağlamaya devam edin, ancak yine de yalnızca tamamlanmış “birimler” (ör. Sınıflar, yapılandırmalar, vb.) Taahhüt edin; böyle bir şey ters giderse hayatınızı kolaylaştıracak (küçük bir değişiklik kümesini geri alabilirsiniz) ve çatışma olasılığını azaltacaktır.

İlgilendiğim kadarıyla, kaynak kontrol deponuz temel proje kurulumunun bir parçası, bu yüzden boş projemi oluşturduktan hemen sonra taahhüt ediyorum.

Dün

... alternatif olarak, eğer zaman yolculuğu yapamıyorsanız ...
(belki de arabanız 88mph'ye ulaşamaz veya akı kapasitörünüz kapandı)

şimdi

Kanlı noktada yeni projeler yapılmalı, bu delilik olmamalı ve çağdaş DVCS sistemleri taahhütleri önlemek için mümkün olan her mazereti kaldırmıştır : git init . ; git add * ; git commit -m initial-commitşimdi olduğu gibi çok geç olmadan.

Bir daha mantıklı, tartışılabilir, soru olabilirdi: "Ben ne zaman birleştirme bir benim kaydedilmesini paylaşılan bir kaynak denetimi ekibinin yönetilen bir de depo kurulan proje?" (sıfatların, sıfatların önemli olduğuna dikkat edin) Ve diğer cevapların çoğunun aslında buna cevap vermeye çalıştığını hissediyorum.

Kişisel şubeniz yatmadan önce en az günde bir kez , deli gibi davranmaya karar vermelidir . Ertesi sabah kalkıp, önceki gece ne yaptığınız hakkında hiçbir fikriniz olmadığını görebilirsiniz. VCS sizi bununla örtmeli ve güzel bir şekilde derlenen, sorunsuz çalışan ve / veya testleri geçen çok yeni bir alt sürümüne geri dönme fırsatına sahip olmak en iyi seçeneğiniz olabilir.

En kısa sürede taahhütte bulunacağımı söyleyebilirim. Kaynak kontrolünün temel amacı, bir şeyler ters gittiğinde geri dönmenize izin vermektir ve bu "erken ve sık davran" uygulamasıyla yankılanır.

Şahsen ilk işim tipik olarak Python kodu için * .py [co] gibi gerekli olacak birkaç filtreye sahip sadece .gitignore dosyasını (ya da eşdeğeri) içeriyor . Temel proje kurulumu ve / veya ilk basit prototip, genellikle aşağıdaki gibidir.

İlk taahhüt, projenin bir satır özeti kadar az bir README dosyası veya projenin ilk dönüm noktası hakkında yeterli bilgi olabilir. Geniş konular şunları da içerebilir:

• Giriş
• Proje Açıklaması
• Proje yapısı
• Kodlama kuralları
• Nasıl yapılır hakkında talimatlar:
  • inşa etmek
  • Ölçek
  • dağıtmak
• Bilinen sorunlar ve geçici çözümler
• yapılacaklar listesi
• Kullanım Şartları

Bir projede değişiklik yapmadan önce README'yi güncelleme uygulaması, ayrıca Benioku Tarafından Geliştirilen Geliştirme olarak da adlandırılır ve bu değişiklikleri yapmaya zaman ayırmadan önce değişiklikleri düşünmenizi sağlar.

Bu yazılıma katkıda bulunmak veya kullanmak isteyen herkes README ile başlayacaktır.

Kaybetmek istemeyeceğiniz bir iş yaptıysanız, kaynak kontrol sisteminizde olması gerekir.

Bu kesinlikle Git gibi dağıtılmış sistemler için geçerlidir. Merkezi bir sistem kullanıyorsanız ve bir şeyi kontrol etmenin tek yolu onu herkesin görmesini sağlamak , uzak durmak isteyebilirsiniz - veya kendi yerel git deponuzu kurmayı ve merkezileştirmeyi düşünebilirsiniz. Hazır olduğunuzda sistem.

Temel kuralım, boş bir kaç dosya içermesine rağmen, çözüm dosyamın (veya başka bir derleme betiğinin) yapılmasından sonra teslim etmektir. Projede birden fazla kişinin çalıştığı durumlar için iyi bir uygulamadır. Bu dosya başlangıçta en kötü birleştirme sorunlarına sahip olma eğilimindedir, çünkü insanlar projeye bir şeyler eklerler, bu nedenle ihtiyaçlar erken ve sık yapılmalıdır.

Projede çalışan tek kişi olsanız ve yalnızca bir dosya olsa bile, aynı iş akışını takip etmeyi ve eldeki sorun için düşünmeyi kaydetmeyi daha kolay buluyorum.

Bahsetti mi emin değilim .

Ancak yaptığınız şeyin kaçtığından / derlendiğinden emin olun ! Yani sözdizimi hatası yok.

Bozuk ödeme kodundan daha sinir bozucu bir şey yok.

Yazılım testi (TDD yaklaşımı) ile ilgili diğer bakış açıları, yeni test durumları yeşil olduğunda en kısa sürede size yardımcı olacaktır. Bu, tamamlanmış yeni bir kod birimine sahip olacağınız anlamına gelir.

Aptalca bir şey yapmadan hemen önce.

Büyülü güçleri olmayanlar için, bu çok az ve sık demek.

Tek başına çalışıyorsanız, bir içki içtiğinizde veya her neyse bunu yapın.

Eğer bir takımda çalışıyorsanız, muhtemelen işin derlendiğinden emin olmanız gerekir, böylece başka biri en son alırsa, bir hata torbası alamazlar. Ama bunun dışında, olabildiğince.

Projeye yaklaşık 2 ~ 3 saat.

Sadece şaka yapıyorum. Tüm durumlara uyacak tek bir iyi cevap yok. Her şeyden önce, eğer dağıtılmış bir sürüm kontrol sisteminiz varsa (git veya Mercurial gibi), yerel reponuzu kabul etmek, feci bir başarısızlık durumunda verilerinizi korumaz. Ancak, özel bir uzak repo size para kazandırabilir, örneğin github'da. Taahhüt tarihçesini koruyacaksınız, ancak benim deneyimimde projeniz biraz ilerleyene kadar buna ihtiyacınız olmayacak.

Ayrıca, başlangıçta, özellikle dosyaları dolaştırıyorsanız, muhtemelen çok fazla karmaşa istemezsiniz. Değişikliklerin yapılması, yalnızca küçük olması durumunda bir yük olacaktır. Bir şeyi atmaya bile karar verebilirsin. Ancak, çoğaltılması önemsiz olmayan değişiklikleri kaybederseniz, bir yedek kopya oluşturmayı özleyeceksiniz ve sürüm kontrol sistemleri son derece değerli yedekleme sistemleri için çalışıyor.

Günümüzde bazı insanlar kodlarını saklamak için DropBox veya benzeri ürünler kullanıyor. Bir projenin başlangıcında iyi bir uzlaşma olabilir, çünkü kurulum için sıfır çaba harcar. Bununla birlikte, özellikle birkaç kişi aynı anda koda dokunduğunda, ciddi yazılım geliştirmede barbarca bir alışkanlıktır.

Bu yüzden, ne zaman değerli olursa olsun, yani çoğaltmak için önemsiz olmayan bir şeyim olduğunda, sürüm kontrolünü ayarlama eğilimindeyim. Değer özneldir (ve kişinin kapasitelerine bağlıdır), bu yüzden kendi kararınızı vermeniz gerekecektir. Bu noktada, harici bir diske ikinci bir depoyu ya da eğer halka açık bir proje ise github'da saklıyorum, aksi halde ödeme hesabım onu ​​tutacak.

Birçok kişi zaten "Hemen" cevabını verdi ve ben% 100 katılıyorum. Ayrıca, Xion'un VCS'nin görmezden gelme biçimleriyle (yani veya eşdeğeri) başlamasını öneriyorum.gitignore .

Sanırım erken kararlar için olumsuz tarafların olmadığı konusunda anlaştık. Eklenti eklemek istiyorum:

• Atmayı seçtiğiniz şeyleri yapma olasılığınız daha düşüktür, ancak bu hala devam etmektedir. Yeni bir gelişmeye başladığımda, hızlı bir şekilde kod yazacağım ve yayınlayacağım ve daha sonra işleme koyduğumda, bir sürü dosya bulunduğunda, yanlışlıkla yalnızca bir sonraki işlemimde silmek için bir şeyler yaptım. Bu, küçük veya hatta boş taahhütlerin aksine, tarihteki gerçek gürültüdür.
• Sistematik bir türseniz ve projelerinizde tipik ilk adımlar varsa, taahhüt noktaları olarak sahip olmaları size ya da başkalarına öğretici olabilir ve hatta belirli bir noktada dalma ve yeniden kullanılabilir bir proje saplaması oluşturma fırsatı da sağlayabilir. Bir Maven projesinin oluşturulmasında, bazı küçük ilk adımlar zaten oldukça önemli bir üs tanımlayabilirsiniz çünkü bu (yararlı oldu Maven tabanlı projeler üzerinde çalıştık ve bu adımlar için çok değil iken yapmak , yeterince gerektirebilir düşünme gerektirecek tekrar Kullanılabilirlik).

Hangi VCS'yi kullandığınıza bağlı olabilir.

Git ile boş bir klasör (veya neredeyse boş bir README dosyası ile) taahhüt ediyorum. Mesele şu ki, geliştirme sürecinin başındayken baştan başlamak istersem (yukarı akıştan önce) tamamen baştan başlamak istersem geri dönüp şubemi bu boş duruma sıfırlayabilirim. Daha sonra "oluşturulan" dosyalarımı işleme koyardım (örneğin görsel stüdyo çözümü). O zaman gerçekten kodlarken, her bir birimi normalde yaptığınız gibi yapmaya başlayacağım.

SVN ile, her bir taahhüdün üstesinden gelmek için bastırıyorsunuz, böylece Git'le yaptığınız gibi başlama lüksünü gerçekten elde edemiyorsunuz. Bu durumda, sürecin başlarında büyük bir yenileme yapacağınızı düşünüyorsanız, erken bir taahhütte bulunmak yararlı olmayabilir. Bu olsa kodlayan kişiye kalmış olacak.

Yeni bir projeye başladığımda genellikle herhangi bir kod eklenmeden önce bunu taahhüt ederek başlıyorum. Her zaman takip ettiğim genel bir kural: Bilgisayarınız tüm verilerinizi kilitleyip sildiyse, hangi kodun bellekten yazmamasını tercih edersiniz. On yıl önce TDD ve daha iyi programlama uygulamalarından önce, hatırlayabildiğim şeyler konusunda oldukça iyimserdim. Şimdi daha temkinli olma eğilimindeyim. Diğer birçok afişin de erken ve çok sık taahhütte bulunduğunu söylediği gibi. Bunu yaparak hiçbir şey kaybetmiyorsunuz.

Çoğu zaman kendi başıma çalışıyorum, bu yüzden itiraf etmeliyim ki gevşeyim ama genelde eve gitmeden önce söz veriyorum. Böylece yarın başaramazsam, meslektaşlarım kaldığım yeri alabilirler.

Şu anda işyerinde Tortoise / SVN kullanıyorum.

Hemen boş projeyi tamamla . Projede çalışmak için harcadığınız saatte birkaç kez taahhüt vermeye devam edin. Kod derlenmese bile kabul et. Bu tür taahhütleri takip etmek için taahhüt masajında ​​“WIP” ile işaretlerim.

Ayrıca, manuel olarak işlemeyi unutmam durumunda, tüm projelerimi her 10 dakikada bir otomatik olarak bir yedek depoya aktaran bir komut dosyası var. Buna benim bulut destekli geri alma tamponumu diyelim.

Kodunuzu görmek için ekibinize ihtiyaç duyduğunuzda projeyi bir ekip deposuna iade edin (aka. İtin ). Muhtemelen benim gibi bir şey varsa, kodunuz ekibiniz tarafından görülmeye hazır olmadan önce.

Takımına güzel olmasını istiyorsanız, ezmek takım repo onları iterek önce kaydedilmesini.

Tüm makalelere baktım ve bence zaten çok sayıda iyi çözümümüz oldu, ancak metodolojimi sizinle paylaşmak istiyorum.

Çerçeve oluşturma (sıfırdan sağa) üzerinde çalışırken, modül tamamlanana veya sonlandırılana kadar her modül için birçok değişiklik yapılacaktır. Bu yüzden her zaman biri DİNAMİK, diğeri de STATİK olarak adlandırılan 2 konum var. Değişiklikler devam ederken ve çerçeve henüz tamamlanmadığında, DYANMIC lokasyonunda gerçekleştirildi ve tamamlandıktan ve tamamlandıktan sonra bunu STATIC konumuna taşıdım. Bu yüzden tam bir Kaynak Kontrolü var.

Teşekkürler

Herhangi bir uygulamada, bileşenleri tasarlamak için biraz zaman harcayacaksınız. Ad alanlarınızı, projelerinizi, dış referanslarınızı, 3. şahıs kütüphanelerinizi vs. kabaca veya tam olarak bilmelisiniz.

Eğer bir takımdaysanız, temel projeyi oluşturmak, bağımlılıkları belirlemek ve seçili olan iskeleti (projenizin temel alacağı temel) yerleştirmek için liderinizi veya kim seçilirse öneriyorum.

Ayrıca, işleminizin sağlam olması için check-in işleminden önce verilen görev, serbest bırakma, bagaj vb. Şubelerinizin olmasını sağlamak istersiniz.

Halen devam etmekte olan bir proje için yeni bir "görev" üzerinde çalışıyorsanız ve kendi görev dalınızdaysanız, gece check-in işlemlerinizi yapın, böylece çalışmanızı koruyun.

Genelde ne zaman yeni bir şey eklersem kontrol ederim, ancak belirli şeyleri ayırmak isterim.

Bu, yeni bir bağımlılık eklersem, değişiklikleri ya derlenene kadar yaparım ya da sıfırdan başlayarak tekrar yapmak için zaman kaybettirecek kadar büyükler. Eğer daha büyük bir görevim varsa, mantıklı olduğu zaman (fonksiyon başına bir kere, onu her seferinde başarılı bir şekilde derleyip çalıştırdığımda, vb.) Birden çok kez taahhüt etmeye çalışıyorum.

Ayrıca bir yedekleme noktası istediğimde (yani, "şimdi denediğim şey işe yaramazsa veya çok karmaşık hale gelirse, şimdi olduğu gibi koda geri dönmek istiyorum" veya birileri benim olduğumu bırakmamı istediğinde söz veriyorum. bazı acil sorunları yapmak ve düzeltmek).

Merkezi bir kaynak kontrol sistemi kullanıyorsanız, yedekleme noktaları için keyfi bir şekilde işlem yapamazsınız, çünkü derleme / çalışma taahhüdü ekibinizdeki herkesi etkiler.

Genellikle kazan kodunu eklemeye başladığımda (örneğin, django web sitesine yeni bir webapp ekleyin), yaptığım her işlemi taahhüt ediyorum.

Kod yazmak / yazmak için bir öğreticiyi takip edersem, eğitim iletilerinde adım adlarını öğreticide kullanırım. Bu şekilde, revizyonları dağıtabilir ve daha sonra herhangi bir noktada bir öğretici adımın ne yaptığını görebilirim.

Örneğin, tek bir kod dosyasından oluşan bir projem var diyelim. Projenin son derece temel işlevsellik (1 veya 2 özellik) ile çalışmasını sağlamak için yaklaşık 10 satır boyler kod kodu ve 100 satır alacaktır.

Malzeme eklemenin ne kadar zor olduğuna bağlı olacaktır:

• kazan plakası kodunu eklemek önemsiz olsaydı, bunu ekler ve diğer koda başlamadan hemen önce yapardım (bu şekilde, eğer bir hata yaparsam ya da garip bir hata yaparsam, sadece kazan koduna geri dönebilir ve başlayabilirim) tekrar).

• Eğer kod önemsiz olmasaydı, her yeni bir şey eklediğimde (her iki kod satırı arasında herhangi bir yerde, yüzlerce ya da öylesine değişti) taahhüt ederim.