You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 1-js/03-code-quality/03-comments/article.md
+10-10Lines changed: 10 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# टिप्पणियाँ
2
2
3
-
जैसा कि हम अध्याय जानकारी:संरचना से जानते हैं, टिप्पणियाँ सिंगल-लाइन हो सकती हैं: // से शुरू, और मल्टीलाइन : /* ... */ से शुरू ।
3
+
जैसा कि हम अध्याय <info:structure> से जानते हैं, टिप्पणियाँ सिंगल-लाइन हो सकती हैं: // से शुरू, और मल्टीलाइन : /* ... */ से शुरू।
4
4
5
5
हम आमतौर पर उनका उपयोग यह वर्णन करने के लिए करते हैं कि कोड कैसे और क्यों काम करता है।
6
6
@@ -22,7 +22,7 @@
22
22
23
23
इसके बारे में एक महान नियम है: "यदि कोड इतना अस्पष्ट है कि उसे एक टिप्पणी की आवश्यकता है, तो शायद इसे इसके बजाय फिर से लिखा जाना चाहिए"।
24
24
25
-
### विधि: कारक बाहर कार्य
25
+
### विधि: function को फ़ैक्टर आउट करें
26
26
27
27
कभी-कभी किसी function के साथ कोड टुकड़ा को बदलना फायदेमंद होता है, जैसे यहाँ:
28
28
@@ -32,7 +32,7 @@ function showPrimes(n) {
32
32
for (let i =2; i < n; i++) {
33
33
34
34
*!*
35
-
//check if i is a prime number जांचें कि क्या i एक प्रमुख संख्या है
35
+
// जांचें कि क्या i एक प्रमुख संख्या है
36
36
for (let j =2; j < i; j++) {
37
37
if (i % j ==0) continue nextPrime;
38
38
}
@@ -43,7 +43,7 @@ function showPrimes(n) {
43
43
}
44
44
```
45
45
46
-
फ़ैक्टर आउट फ़ंक्शन`isPrime` के साथ बेहतर संस्करण:
46
+
फ़ैक्टर आउट function`isPrime` के साथ बेहतर संस्करण:
47
47
48
48
49
49
```js
@@ -90,7 +90,7 @@ for(let t = 0; t < 3; t++) {
90
90
// ...
91
91
```
92
92
93
-
फिर इसे कार्यों को दोबारा करने के लिए यह एक बेहतर संस्करण हो सकता है जैसे:
93
+
फिर इसे करने के लिए एक बेहतर संस्करण हो सकता है functions का प्रयोग करना:
94
94
95
95
```js
96
96
addWhiskey(glass);
@@ -111,7 +111,7 @@ function addJuice(container) {
111
111
}
112
112
```
113
113
114
-
एक बार फिर, functions स्वयं बताते हैं कि क्या हो रहा है। टिप्पणी करने के लिए कुछ भी नहीं है। और विभाजित होने पर कोड संरचना भी बेहतर होती है। यह स्पष्ट है कि प्रत्येक कार्य क्या करता है, यह क्या लेता है और यह क्या लौटाता है।
114
+
एक बार फिर, functions स्वयं बताते हैं कि क्या हो रहा है। टिप्पणी करने के लिए कुछ भी नहीं है। और विभाजित होने पर कोड संरचना भी बेहतर होती है। यह स्पष्ट है कि प्रत्येक function क्या करता है, यह क्या लेता है और यह क्या लौटाता है।
115
115
116
116
वास्तव में, हम "व्याख्यात्मक" टिप्पणियों से पूरी तरह से बच नहीं सकते हैं। जटिल एल्गोरिदम होते हैं और अनुकूलन के प्रयोजनों के लिए चतुर "बदलाव" हैं। लेकिन आम तौर पर हमें कोड को सरल और स्व-वर्णनात्मक रखने का प्रयास करना चाहिए।
117
117
@@ -123,7 +123,7 @@ function addJuice(container) {
123
123
: घटकों का एक उच्च-स्तरीय अवलोकन प्रदान करें, वे कैसे बातचीत करते हैं, विभिन्न स्थितियों में नियंत्रण प्रवाह क्या है... संक्षेप में - कोड के बारे में विहंगम दृष्टि। कोड की व्याख्या करने वाले उच्च-स्तरीय आर्किटेक्चर आरेख बनाने के लिए एक विशेष भाषा [UML](http://wikipedia.org/wiki/Unified_Modeling_Language) है। निश्चित रूप से ये अध्ययन करने लायक।
124
124
125
125
दस्तावेज़ फ़ंक्शन पैरामीटर और उपयोग
126
-
: किसी फ़ंक्शन का दस्तावेज़ीकरण करने के लिए एक विशेष सिंटैक्स [JSDoc](http://en.wikipedia.org/wiki/JSDoc) है: उपयोग, पैरामीटर, लौटाया गया मान।
126
+
: किसी function का दस्तावेज़ीकरण करने के लिए एक विशेष सिंटैक्स [JSDoc](http://en.wikipedia.org/wiki/JSDoc) है: उपयोग, पैरामीटर, लौटाया गया मान।
127
127
128
128
उदाहरण के लिए:
129
129
```js
@@ -139,9 +139,9 @@ function pow(x, n) {
139
139
}
140
140
```
141
141
142
-
इस तरह की टिप्पणियाँ हमें फ़ंक्शन के उद्देश्य को समझने और इसके कोड को देखे बिना इसका सही तरीके से उपयोग करने की अनुमति देती हैं।
142
+
इस तरह की टिप्पणियाँ हमें function के उद्देश्य को समझने और इसके कोड को देखे बिना इसका सही तरीके से उपयोग करने की अनुमति देती हैं।
143
143
144
-
वैसे, [वेबस्टॉर्म](https://www.jetbrains.com/webstorm/) जैसे कई संपादक उन्हें भी समझ सकते हैं और स्वत: पूर्ण और कुछ स्वचालित कोड-जांच प्रदान करने के लिए उनका उपयोग कर सकते हैं।
144
+
वैसे, [WebStorm](https://www.jetbrains.com/webstorm/) जैसे कई संपादक उन्हें भी समझ सकते हैं और स्वत: पूर्ण और कुछ स्वचालित कोड-जांच प्रदान करने के लिए उनका उपयोग कर सकते हैं।
145
145
146
146
साथ ही, [JSDoc 3](https://github.com/jsdoc3/jsdoc) जैसे टूल हैं जो टिप्पणियों से HTML-दस्तावेज़ीकरण उत्पन्न कर सकते हैं। आप JSDoc के बारे में अधिक जानकारी <http://usejsdoc.org/> पर पढ़ सकते हैं।
0 commit comments