मैंने पहले कभी भी अपना कोड दस्तावेज करने के बारे में बहुत ज्यादा परवाह नहीं की, लेकिन हाल ही में मैंने ओपन सोर्स प्रोजेक्ट पर काम करना शुरू कर दिया और जरूरत उठ गई। जाहिर है, 'पसंद का हथियार "PHPDoc है, लेकिन ...PHPDoc की स्थिति क्या है?
मुझे वास्तव में PHPDoc मानक का एक भी विनिर्देश नहीं मिल सका। वहां कुछ विकिपीडिया प्रविष्टि सूचीबद्ध हैं और कुछ phpDocumentor प्रोजेक्ट है, जो phpDocumentor प्रोजेक्ट है, माना जाता है कि एक और व्यापक शब्दकोश है, लेकिन PHPDoc की निश्चित मार्गदर्शिका कहां है, जहां कोई पहेली है? क्या कोई एकल मानक है या यह उन सभी phpDocumentor knockoffs पर निर्भर करता है जो PHPDoc "मानक" (यदि कोई हो) को जो कुछ भी लगता है फिट।
यदि हम मानते हैं कि phpDocumentor वह जगह है जहां PHPDoc मानक बनाया और बनाए रखा जाता है, तो चीजें बहुत गंभीर लगती हैं, क्योंकि the project's website लगभग 4 वर्षों से मर चुका है। और मुझे और भी पहेली क्या है महीने पहले एक संस्करण 1.4.4 अचानक phpDocumentor की पियर साइट पर मृतकों से दिखाई दिया।
मुझे पता है कि यहां बहुत अधिक बुद्धिमान और जानकार साथी हैं, इसलिए मैं जानना चाहता हूं। PHPDoc के साथ सौदा क्या है। क्या कोई एकल प्राधिकरण मानक बनाता है? यह कितना विश्वसनीय है? वहाँ किसी भी भविष्य है या हम एक ज़ोंबी के साथ काम कर रहे हैं और सभी आशा खो दिया है ...
धन्यवाद, इवो
स्टैक ओवरफ़्लो –
@ डैगन - मैं अलग-अलग होना चाहता हूं। यह [व्यावहारिक, उत्तरदायी समस्याओं के तहत आता है जो प्रोग्रामिंग पेशे के लिए अद्वितीय हैं]] (http://stackoverflow.com/faq)। –
संदर्भ के लिए, थोड़ी देर में अपडेट नहीं की जा रही साइट साइट (या उस मामले के लिए परियोजना) "मृत" नहीं बनाती है। यह सिर्फ इतना हो सकता है कि 3 साल से अधिक के लिए एक नया संस्करण * आवश्यक * नहीं किया गया है, क्योंकि सॉफ्टवेयर इसकी बात करता है और यह अच्छा करता है। – cHao