खोज…


परिचय

विषयों को यथासंभव सरल बनाया जाना चाहिए, लेकिन सरल नहीं। यह एक स्टैक ओवरफ्लो दस्तावेज़ीकरण पर देखे गए कुछ आयोजन सिद्धांतों का सुझाव देता है।

भाषा फीचर विषय

एक प्राकृतिक विभाजन बस प्रत्येक भाषा सुविधा के लिए एक विषय बनाने के लिए है। उदाहरण के लिए, पायथन में है:

  • कक्षाएं
  • कार्य
  • जेनरेटर
  • सज्जाकार
  • । । ।

नकारात्मक पक्ष पर, सुविधाएँ काफी जटिल हो सकती हैं और एक पृष्ठ के लिए समझ बनाने की तुलना में कई और उदाहरणों के साथ आना आसान है। उदाहरण के लिए कक्षाओं में 16 उदाहरण हैं। उनमें से कुछ को शायद अन्य फीचर विषयों में ले जाया जा सकता है, जैसे कि इनहेरिटेंस, गुण, तरीके, आदि।

बैग विषय पकड़ो

कुछ विषय एक विषय के तहत शिथिल जुड़े उदाहरण हैं, जैसे C # 6.0 विशेषताएँ और सामान्य नुकसान । कुल मिलाकर, विषय की इस शैली को हतोत्साहित किया गया क्योंकि प्रति विषय उदाहरण सीमित थे क्योंकि सामग्री जोड़ने से रोकने के लिए कोई प्राकृतिक स्थान नहीं है।

शायद उदाहरणों को किसी अन्य विषय (शायद भाषा सुविधाओं के लिए ) में स्थानांतरित करना बेहतर है। मैंने ऐसा नहीं देखा है, लेकिन यह संभव है कि इन विषयों को एक मेटा विषय में परिवर्तित किया जा सकता है जिसमें एक उदाहरण या दो शामिल हैं जिनमें बड़े पैमाने पर अन्य विषयों या उदाहरणों के लिंक शामिल हैं:

पर्ल टिप्स एंड ट्रिक्स



Modified text is an extract of the original Stack Overflow Documentation
के तहत लाइसेंस प्राप्त है CC BY-SA 3.0
से संबद्ध नहीं है Stack Overflow