Kod Aracina Baglamli Brif Vermek

Neden onemli

Kod asistanlari dosyalarini gorur ama niyetini bilmez. Bes dosya acikken "menuyu duzelt" demek, duzenlemeyi makul gorunen dosyaya dusurur. Uc satirlik devir mesaji (proje ne, hangi dosyalar onemli, istenen tek degisiklik ne) araci sohbetteki brif gibi nisanlar. M04 ile M07 arasi her duzenleme bu kalibi kullanir.

Kavramlar

Devir dort bolmelidir: proje (README ilk satirin), dosyalar (onemli adlar, taze yapistirilmis), degisiklik (M02L8 kabul olcutlu tek degisiklik) ve cit (el degmemesi gereken). Ornek: "Mahalle firini tek sayfa site (index, styles, app). Dosyalar: index.html menu bolumu, styles.css menu kurallari. Degisiklik: yemek adlari telefon genisliginde aciklamalardan buyuk. Cit: tum metin, renkler ve formu koru."

Tek degisiklik, dar kapsam. "Menuyu bicimle" degisikliktir; "menuyu bicimle, formu iyilestir, fotograf ekle" tek mesaja binmis uc istektir. Dar kapsam dosyayi adlandirmak demektir: "yalniz styles.css icinde" her zaman "projenin bir yerinde" yener. Duzenleme donunce kabulden once neyin degistigini oku: hangi dosya, hangi satirlar, olcute uyuyor mu? Koru korune kabul, M01L1 guven hatasinin editor halidir.

Baglam eskir. Yeniden adlandirma ya da buyuk duzenleme sonrasi dosya listesini yeniden yapistir. Dunun adlariyla calisan arac dunun dosyalarini duzenler. M06L23 devir isini yeniden kullanilabilir proje ozetine cevirecek; simdilik liste her degistiginde taze yapistir.

Uygulamali ornek

Kotu devir: "Menu garip duruyor, duzelt." Arac yanlis dosyayi bicimler, HTML'de olmayan sinifi yeniden adlandirir; menu ayni kalir, baska bir sey kayar. Iyi devir: proje satiri, iki dosya adi, olcutlu tek degisiklik ("yemek adlari aciklamalardan buyuk, fiyatlar 360px'te saga hizali"), cit ("metin, renk, form korunsun"). Duzenleme yalniz styles.css dosyasina dokunur; 360px'te otuz saniyede dogrularsin, bitti.

Beklenen sonuc: sonraki gercek duzenlemene 120 kelime alti, dort bolmeli devir mesaji.

Sik yapilan yanlis

Yapistir-ve-umu: tum projeyi araca dokup "daha iyi yap" demek ve sonucu okumadan kabul etmek. Buyuk yapistirmalar kimsenin incelemedigi buyuk farklar uretir; calisan formlar bicim seanslarinda boyle olur.

Lab ve sonraki adim

Lab A10 araca firin sayfasi iskeleti icin brif verir, duzenlemeyi okuyarak dogrular. Sirada 14. ders var: insa sirasi; once yapi, sonra metin, bicim ve davranis; her biri sonrakinden once kontrollu.