Skip to content

Commit 678cf3f

Browse files
fix typo
1 parent cf5adde commit 678cf3f

File tree

4 files changed

+30
-30
lines changed

4 files changed

+30
-30
lines changed

1-js/03-code-quality/01-debugging-chrome/article.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Daha karmaşık kodlara geçmeden, hata ayıklama hakkında konuşmamız gerekme
66

77
Geliştirici özellikleri en iyi olan tarayıcı Chrome olduğundan bu tarayıcı ile çalışacağız.
88

9-
## "Kaynak" paneli
9+
## "Kaynak" paneli
1010

1111
Şu anda sizin kullandığınız Chrome biraz farklı olabilir. Fakat bu panel kesinlikle orada biryerde olmalı
1212

@@ -25,9 +25,9 @@ Bu panelde `hello.js` i seçtiğinizde aşağıdaki gibi bir ekran görmeniz ger
2525
![](chrome-tabs.svg)
2626

2727
Bu bölüm üçe ayrılmıştır:
28-
1. **Dosya Gezgini**: Html, javascript, css ve diğer dosyalar görseller de dahil olmak üzere açılan sayfaya iat olan kaynakları gösterir. Chrome eklentileri de burada yer alabilir.
28+
1. **Dosya Gezgini**: Html, javascript, css ve diğer dosyalar görseller de dahil olmak üzere açılan sayfaya ait olan kaynakları gösterir. Chrome eklentileri de burada yer alabilir.
2929
2. **Kod Editörü** burası ise kaynak kodu gösterir.
30-
3. **Bilgi ve kontrol bölgesi** burada ise hata ayıklama yapılır.
30+
3. **Bilgi ve kontrol bölgesi** burada ise hata ayıklama yapılır.
3131

3232
Şimdi geliştirici araçlarının sol köşesinde bulunan <span class="devtools" style="background-position:-172px -122px"></span> açma kapama bölümünü kullanarak kendinize biraz yer açabilirsiniz.
3333

@@ -97,10 +97,10 @@ Lütfen bilgilerin görüneceği dropdownları sağ panelden açınız. Bu böl
9797

9898
1. **`Watch` -- herhangi bir ifadenin o anki değerini gösterir.**
9999
`+` işaretine basarak ifade girebilirsiniz. Bu ifadenin değerini kod ayıklayıcı her halükarda gösterir. Kod çalışırken bu değerleri her adımda kontrol eder ve sonucunu yazar.
100-
100+
101101
2. **`Call Stack` -- İç içe çağrı zincirlerini gösterir.**
102102

103-
Şu anda hata ayıklayıcı `merhaba()` fonksiyonunun içindedir ve `index.html` tarafından çağırılmıştır. Eğer yığın(stack) bölgesine dikkat ederseniz fonksiyona girdiğinde nereden çağırıldığını gösterir. ( her hangi bir fonksiyondan çağırılmadığından dolayı "anonymous" olarak göreceksiniz)
103+
Şu anda hata ayıklayıcı `merhaba()` fonksiyonunun içindedir ve `index.html` tarafından çağırılmıştır. Eğer yığın(stack) bölgesine dikkat ederseniz fonksiyona girdiğinde nereden çağırıldığını gösterir. ( herhangi bir fonksiyondan çağırılmadığından dolayı "anonymous" olarak göreceksiniz)
104104

105105
Eğer yığın maddesine tıklayacak olursanız hangi fonksiyondan çağırıldığını görebilirsiniz.
106106
3. **`Scope` -- kesme anında var olan değişkenlerin değerlerini gösterir**
@@ -134,7 +134,7 @@ Sağ panelin üstünde sadece bu işe has butonlar bulunmaktadır.
134134
: Bir öncekinin aynısı, bir adım gider fakat bu defa eğer bir fonksiyon varsa onun "içine girer"(step into).
135135

136136
<span class="devtools" style="background-position:-104px -76px"></span> -- içinde bulunulan fonksiyonun sonuna kadar devam et, `key:Shift+F11`.
137-
: Çalışma içinde bulunan fonksiyonun sonuna gelir ve orada durur.Yanlışlıkla iç içe çağrının içine girilirse çıkmak için kullanışlı bir özelliktir.<span class="devtools" style="background-position:-72px -76px"></span>,
137+
: Çalışma içinde bulunan fonksiyonun sonuna gelir ve orada durur.Yanlışlıkla iç içe çağrının içine girilirse çıkmak için kullanışlı bir özelliktir.<span class="devtools" style="background-position:-72px -76px"></span>,
138138

139139
<span class="devtools" style="background-position:-7px -28px"></span> -- Tüm kesme noktalarını etkinleştirme/devre dışı bırakma.
140140

@@ -166,10 +166,10 @@ Bahsettiğimiz gibi çalışan kodu durdurmanın üç farklı yönü vardır. Bu
166166
2. `debugger` kelimesi ile durdurma
167167
3. Eğer hata olduğunda aç/kapa butonu aktifse çalışmada hata olduğunda <span class="devtools" style="background-position:-264px -4px"></span> durdurma
168168

169-
Bunların sonucunda çalışmada ne gibi hatalar olduğunu görebilirsiniz.
169+
Bunların sonucunda çalışmada ne gibi hatalar olduğunu görebilirsiniz.
170170

171171
Bunlara ek olarak <https://developers.google.com/web/tools/chrome-devtools> adresinden daha geniş ve yeni bilgilere ulaşabilirsiniz.
172172

173173
Bu bölümdeki bilgiler sizin hata ayıklama işlemine başlamanızda yardımcı olacaktır. Fakat tarayıcı ile alakalı çok fazla işlem yapıyorsanız bu durumda geliştirici derinlemesine incelemeniz gerekmektedir.
174174

175-
Tabi bunun yanında deneme yanılma yöntemiy ile de geliştirici araçlarının özelliklerini keşfedebilirsiniz. Unutmayın sağ tıklayarak farklı bölgelerde farklı fonksiyonları görebilirsiniz.
175+
Tabi bunun yanında deneme yanılma yöntemi ile de geliştirici araçlarının özelliklerini keşfedebilirsiniz. Unutmayın sağ tıklayarak farklı bölgelerde farklı fonksiyonları görebilirsiniz.

1-js/03-code-quality/02-coding-style/article.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Buna yardımcı olan bir şey de iyi kodlama stilidir.
99

1010
## Yazım
1111

12-
Kodlar için yazımış bir kopya kağıdı(detayları aşağıda):
12+
Kodlar için yazılmış bir kopya kağıdı(detayları aşağıda):
1313

1414
![](code-style.svg)
1515
<!--
@@ -38,7 +38,7 @@ if (n < 0) {
3838
-->
3939
Şimdi bu kurallar ve nedenleri hakkında konuşabiliriz.
4040

41-
Buradaki hiçbir şey kanun değildir. Hepsi sizin zevgine kalmıştır ve değişebilir. Buradaki kodlama kuralları dogmalara dayanmaz.
41+
Buradaki hiçbir şey kanun değildir. Hepsi sizin zevkinize kalmıştır ve değişebilir. Buradaki kodlama kuralları dogmalara dayanmaz.
4242

4343
### Süslü Parantez
4444

@@ -47,7 +47,7 @@ Buradaki hiçbir şey kanun değildir. Hepsi sizin zevgine kalmıştır ve deği
4747

4848
```js
4949
if (kosul) {
50-
// şunu yap
50+
// şunu yap
5151
// ...bunu yap
5252
// ...sonra bunu yap
5353
}
@@ -91,7 +91,7 @@ Satır uzunluğu limitine takım seviyesinde karar verilir. Genelde 80-120 karak
9191
İki türlü satır başı standardı vardır.
9292

9393
- **Yatay boşluklar:2(4) boşluk.**
94-
94+
9595
Yatay boşluklar genelde 2 veya 4 veya "Tab" sembolünden oluşur. Bunlardan hangisinin seçilmesi gerektiği bir çeşit savaştır. Bugünlerde boşluk tuşu ile boşluk bırakmak daha fazla kullanılan yöntemdir.
9696

9797
Boşluk tuşu ile satıra başlamanın "Tab" a göre üstünlü daha esnek ayarlanabilir olmasından dolayıdır.
@@ -100,7 +100,7 @@ Satır uzunluğu limitine takım seviyesinde karar verilir. Genelde 80-120 karak
100100

101101
```js no-beautify
102102
goster(parametreler,
103-
hizalandı, // soldan 5 boşluk
103+
hizalandı, // soldan 5 boşluk
104104
ilki,
105105
sonra,
106106
digeri
@@ -125,7 +125,7 @@ Satır uzunluğu limitine takım seviyesinde karar verilir. Genelde 80-120 karak
125125
}
126126
```
127127

128-
Eğer okunurluluğa etki edecekse yeni bir satır arası vermekten çekinmeyin. Kanıya göre 9 satıdan fazla kod varsa arada kesin bir satır arası olmalıdır.
128+
Eğer okunurluluğa etki edecekse yeni bir satır arası vermekten çekinmeyin. Kanıya göre 9 satırdan fazla kod varsa arada kesin bir satır arası olmalıdır.
129129

130130
### Noktalı virgül
131131

@@ -179,7 +179,7 @@ function ust(x, n) {
179179
}
180180
181181
return sonuc;
182-
}
182+
}
183183
}
184184
```
185185

@@ -202,11 +202,11 @@ function ust(x, n) {
202202
}
203203
```
204204

205-
... fakat ikincisi daha okunaklıdır, çünkü `n<0` koşulu ilk önce kontrol edildi ve buna göre aksiyon alındı sonrsında ana kod akışına devam edildi, ayrıca bir `else` yazmaya gerek kalmadı.
205+
... fakat ikincisi daha okunaklıdır, çünkü `n<0` koşulu ilk önce kontrol edildi ve buna göre aksiyon alındı sonrasında ana kod akışına devam edildi, ayrıca bir `else` yazmaya gerek kalmadı.
206206

207207
## Kodun altında fonksiyonlar
208208

209-
Eğer bir kaç tane "helper"(yardımcı) fonksiyon yazıyorsanız bunları yerleştirmenin üç farklı yolu var.
209+
Eğer birkaç tane "helper"(yardımcı) fonksiyon yazıyorsanız bunları yerleştirmenin üç farklı yolu var.
210210

211211
1. Kullanan kodun üstünde fonksiyonları tanımlamak:
212212

@@ -258,7 +258,7 @@ Eğer bir kaç tane "helper"(yardımcı) fonksiyon yazıyorsanız bunları yerle
258258

259259
## Stil Klavuzu
260260

261-
Stil klavuzları genel olarak "nasıl yazılmalı" sorusunun cevabını verir: Kaç satır bırakılmalıdırı, nerede yeni satıra geçilmelidir vs. çok küçük küçük şeyler.
261+
Stil klavuzları genel olarak "nasıl yazılmalı" sorusunun cevabını verir: Kaç satır bırakılmalıdır, nerede yeni satıra geçilmelidir vs. çok küçük küçük şeyler.
262262

263263
Genel olarak tüm takım üyeleri bu kurallara uyduğunda kod tek bir elden çıkmış gibi görünür. Kimin yazdığı önemini yitirir.
264264

@@ -279,15 +279,15 @@ Kod stilinizi otomatik olarak denetleyen araçlar bulunmaktadır. Bunlara "düze
279279

280280
Bunların en önemli özelliği stili kontrol etmesinin yanında yazımdaki hataları, fonksiyon isimlerindeki problemleri bulur.
281281

282-
Bundan dolayı bir tanesini kullanmanız öneririli. Sadece kelime hatalarını düzeltmeniz için bile olsa kullanmanız iyidir.
282+
Bundan dolayı bir tanesini kullanmanız öneririlir. Sadece kelime hatalarını düzeltmeniz için bile olsa kullanmanız iyidir.
283283

284284
En çok bilinen araçlar:
285285

286286
- [JSLint](http://www.jslint.com/) -- ilk düzenleyicilerden
287287
- [JSHint](http://www.jshint.com/) -- JSLintden daha fazla özelliğe sahip.
288288
- [ESLint](http://eslint.org/) -- en yenilerinden.
289289

290-
Hepside işinizi görür. Yazar [ESLint](http://eslint.org/) kullanmatadır.
290+
Hepside işinizi görür. Yazar [ESLint](http://eslint.org/) kullanmaktadır.
291291

292292
Çoğu otomatik düzenleyici editör ile entegre çalışır. Sadece plugin'i aktif edin, kod stilini ayarlayın yeterli.
293293
@@ -317,7 +317,7 @@ Buradaki `"extends"` normalde `eslint:recommended` i kullanacağımız fakat bun
317317
318318
Bunun ardından editörünüzde ESLint eklentisini aktif edin. Çoğu editörde bu eklenti bulunmaktadır.
319319
320-
Bunun yanında bu stilleri internetten indirip kullanmakta mümkündür. Bunun için
320+
Bunun yanında bu stilleri internetten indirip kullanmakta mümkündür. Bunun için
321321
<http://eslint.org/docs/user-guide/getting-started> adresine bakabilirsiniz.
322322
323323
Bunun yanında otomatik düzenleyici kullanmanın yan etkileri de vardır. Kod düzenleyiciler eğer tanımlanmamış bir değişken kullanılmışsa, bunu anlar ve vurgular. Fakat çoğu defa bunun nedeni yanlış yazımdır. Tabi bunu farkederseniz düzeltmesi de hemen yapılabilir.
@@ -329,7 +329,7 @@ Ayrıca bazı IDEler bu otomatik düzenleyicileri kendileri doğrudan entegre ed
329329
330330
## Özet
331331
332-
Bu bölümdeki tüm yazım kurallar ve stil klavuzlarının amacı okunabilrliği artırmaktır. Bundan dolayı tamamı tartışılabilir.
332+
Bu bölümdeki tüm yazım kurallar ve stil klavuzlarının amacı okunabilirliği artırmaktır. Bundan dolayı tamamı tartışılabilir.
333333
334334
"Nasıl daha iyi yazarız?" sorusu hakkında düşündüğümüzde, kriter "Nasıl daha iyi okunur kod yazabilir, nasıl yazarken hatalardan kaçabiliriz?" sorularını aklımızda tutmamız gereklidir. Buna göre stil seçip hangisinin daha iyi olduğuna karar verebiliriz.
335335

1-js/03-code-quality/03-comments/article.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<info:structure> bölümünden de bildiğiniz üzre, yorumlar tek satır `//` olabileceği gibi birden çok satır da olabilir `/* .. */`.
44
Genelde yorum satırları kodun nasıl ve niçin çalıştığını anlatmak için kullanılır.
55

6-
İlk görüşte yorum yapmanın gereklilik olduğu aşikardır. Fakat programlama yeni başlayanlayanlar bunu ilk önce genelde yanlış anlamaktadırlar.
6+
İlk görüşte yorum yapmanın gereklilik olduğu aşikardır. Fakat programlama yeni başlayanlar bunu ilk önce genelde yanlış anlamaktadırlar.
77

88
## Kötü Yorum
99

@@ -51,7 +51,7 @@ function asalSayilariGoster(n) {
5151
for (let i = 2; i < n; i++) {
5252
*!*if (!asalMi(i)) continue;*/!*
5353

54-
alert(i);
54+
alert(i);
5555
}
5656
}
5757

@@ -109,18 +109,18 @@ function addJuice(kap) {
109109
```
110110
Tekrardan söylemek gerekirse nelerin olup bittiğini yorum değil, fonksiyonun kendisi söylemeli.Ayrıca kod yapısı fonksiyonlar şeklinde ayrık olduğunda daha düzgün olur. Her fonksiyonun ne argüman aldığı ne geri döndürdüğü bellidir.
111111

112-
Gerçekte neyin olup bittiğini söyleyen yorumu tamamen çıkarmak olanaksızdır. Bazen karmaşık algorimalara olabilir. Bazen akıllıca yapılmış kısayollar olabilir. Fakat genel olarak kod basit ve kendi kendini açıklayıcı olmalı.
112+
Gerçekte neyin olup bittiğini söyleyen yorumu tamamen çıkarmak olanaksızdır. Bazen karmaşık algorimalar olabilir. Bazen akıllıca yapılmış kısayollar olabilir. Fakat genel olarak kod basit ve kendi kendini açıklayıcı olmalı.
113113

114114

115115
## İyi yorum
116116

117117
Peki, fonksiyonun ne yaptığını anlatan yorumlar kötü ise, hangi yorumlar iyi?
118118

119119
Mimariyi tanımla
120-
: Üst seviyede bileşenlere genel bakış, nasıl birbirleriyle iletişim kurdukları, farklı durumlarda akışın nasıl değişeceği gibi konular anlatılmalıdır. Kusaca kuş bakışı kodun ne yaptığını anlatmalısınız. Bununla ilgili şema diline [UML](https://tr.wikipedia.org/wiki/UML) bakabilirsiniz. Kesinlikle üstünde çalışılmaya değer.
120+
: Üst seviyede bileşenlere genel bakış, nasıl birbirleriyle iletişim kurdukları, farklı durumlarda akışın nasıl değişeceği gibi konular anlatılmalıdır. Kısaca kuş bakışı kodun ne yaptığını anlatmalısınız. Bununla ilgili şema diline [UML](https://tr.wikipedia.org/wiki/UML) bakabilirsiniz. Kesinlikle üstünde çalışılmaya değer.
121121

122122
Fonksiyon kullanımını dökümante etme
123-
: Fonksiyonu dökümante edebilmek için standart özel bir yazım vardır[JSDoc](http://tr.wikipedia.org/wiki/JSDoc). Fonksiyon: kullım, parametreler, dönen değer.
123+
: Fonksiyonu dökümante edebilmek için standart özel bir yazım vardır[JSDoc](http://tr.wikipedia.org/wiki/JSDoc). Fonksiyon: kullanım, parametreler, dönen değer.
124124

125125
Örneğin:
126126
```js
@@ -135,7 +135,7 @@ Fonksiyon kullanımını dökümante etme
135135
...
136136
}
137137
```
138-
Bu yorumlar gize bu fonksiyonun amacının ne olduğunu koda bakmadan anlatır.
138+
Bu yorumlar bize bu fonksiyonun amacının ne olduğunu koda bakmadan anlatır.
139139

140140
Bu arada [WebStorm](https://www.jetbrains.com/webstorm/) gibi editörler size JSDoc yazma konusunda yardımcı olur. Otomatik olarak kodu kontrol edebilir.
141141

1-js/03-code-quality/04-ninja-code/article.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Harika görselin belirli bir formu yoktur.
6161
```
6262

6363
Bir kelime seçerken soyut olmasına önem verin. Örneğin
64-
While choosing a name try to use the most abstract word. Like `obj`, `data`, `value`, `item`, `elem` vs.
64+
Bir isim seçerken en soyut kelimeyi kullanmaya çalışın. `obj`, `data`, `value`, `item`, `elem` gibi.
6565

6666
- **Kusursuz değişken ismi `data`** nerede isterseniz kullanın. Gerçekten de tüm değişkenler *data* tutmuyorlar zaten, değil mi?
6767

@@ -192,7 +192,7 @@ Sonrasında dışta bulunan `kullanici` değişkenine bakacak ve `kullaniciBilgi
192192

193193
Bazı fonksiyonlar hiçbir şey değiştirmiyormuş gibi görünür. Örneğin `hazirMi()`, `izinKontrol()`, `tagbul()` gibi. Hesaplamaları yapıp veriyi geri döndürdüğü ve bunun dışında bir değişiklik yapılmadığı tahmin edilsin. Diğer bir deyişle "yan etkisi" olmadığı.
194194

195-
**En güzel kurnazlık bunlara kendi görevleri dışında "işe yarar" bir eylem yaptırın**
195+
**En güzel kurnazlık bunlara kendi görevleri dışında "işe yarar" bir eylem yaptırın**
196196

197197
İş arkadaşınızın yüzündeki şaşkınlığı düşünebiliyor musunuz? `hazirMi`,`kontrolEt`, `bul...` gibi fonksiyonlar bir şeyleri değiştiriyor. Gerçekten de sınırları zorlayan bir yöntem.
198198

0 commit comments

Comments
 (0)