अगर मेरे पास कोड का एक टुकड़ा है जो गणितीय या संरचनात्मक रूप से काफी जटिल और अनियमित रूप से ऐसा है, तो मैं इस कोड के टुकड़े के दस्तावेजीकरण के बारे में कैसे जाऊंगा? विशेष रूप से, मैं यह कैसे सुनिश्चित कर सकता हूं कि जिस व्यक्ति के पास गणितीय या वास्तु कौशल नहीं है, मैं इसे प्रलेखन से समझ सकता हूं? क्या मुझे गणित के सभी दस्तावेज भी चाहिए? एक ट्यूटोरियल के लिए लिंक? क्या जटिल संरचनाओं के मामले में कुछ दृश्य सहायता लिंकेज है?
1
यह स्पष्ट रूप से इस बात पर बहुत हद तक निर्भर करेगा कि कोई गणितीय जटिलता या वास्तुशिल्प जटिलता के बारे में बात कर रहा था या नहीं। वे सभी समान तरीके से प्रलेखित नहीं हैं। यह किसका है?
—
एडवर्ड स्ट्रेंज
संबंधित: एक प्रोग्रामर को कोड के पीछे विस्तारित तर्क की व्याख्या कहां करनी चाहिए? । मुझे विशेष रूप से परीक्षणों-जैसे-ए-डॉक दृष्टिकोण का जवाब में से एक में सुझाव दिया गया है।
—
कुटकी
@MarkBooth अधिकार, संबंधित प्रश्न का सुझाव देते समय यह ज्यादातर आपका जवाब था जो मुझे ध्यान में था। उत्तर अच्छा आम तौर पर है, लेकिन परीक्षण के बारे में बात विशेष रूप से एक घंटी बजा के रूप में मैं इसे का उपयोग किया था एक बार एक विशेष रूप से जटिल एल्गोरिथ्म कार्यान्वयन के लिए
—
कुटकी