रूबी एंड रूबी ऑन रेल्स पॉपुलैरिटी प्रॉब्लम - बेचारा डॉक्यूमेंटेशन

मैं अपने विचार साझा करना चाहता हूं। मैंने रूबी, रूबी ऑन रेल्स, रूबी बनाम पीएचपी, पायथन बनाम पीएचपी पर कई विषयों को पढ़ा। "प्रत्येक सैंडपाइपर अपने दलदल की प्रशंसा करता है।" मेरा मानना ​​है कि यह विशुद्ध रूप से हर किसी का मामला है - कौन सी प्रणाली या प्रोग्रामिंग भाषा का उपयोग करना है, व्यक्तिगत वरीयताओं, जैसा कि वे कहते हैं, साथियों के स्वाद और रंग की खोज करना। लेकिन बात यह भी नहीं है। मैं अच्छी तरह से PHP जानता हूँ, इतना समय पहले मैंने रूबी और रूबी का रेल पर अध्ययन शुरू नहीं किया था। आपको पता है कि यह कितना अजीब लगता है, लेकिन मुझे दोनों सिस्टम पसंद हैं - दोनों PHP और रूबी, शायद समान भी। रूबी के अपने आकर्षण होते हैं जो इसे अपील करते हैं - भाषा की शक्ति, बहुत स्पष्ट और संक्षिप्त वाक्य रचना (यदि आप वास्तव में अध्ययन के लिए दृष्टिकोण करते हैं), PHP में - सरलता और भाषा के सभी एक ही शब्दावलियों। अच्छे सिस्टम, अच्छे उपकरण, लेकिन फिर भी रूबी किसी तरह पकड़ने की भूमिका में है। यहाँ क्या गलत है?

और यही मैंने सोचा था। अगर रूबी अब इतनी आकर्षक और फैशनेबल विकास की भाषा है, तो इसका प्रचार किसी तरह की लकीर के साथ क्यों आता है? ऐसा लगता है कि सब कुछ स्पष्ट और समझने योग्य है, लेकिन कुछ स्पष्ट रूप से गायब है। लेकिन अनिवार्य रूप से सबसे महत्वपूर्ण चीज गायब है - अच्छा प्रलेखन। मैं कई आपत्तियों का निराकरण करता हूं। हाँ, यह है, लेकिन किस रूप में? आधिकारिक वेबसाइट पर डॉक के कई लिंक हैं। सब कुछ अच्छा लगता है, सब बहुतायत में। लेकिन! मुझे, मैं उस दस्तावेज़ पर कैसे भरोसा कर सकता हूं जिसमें मुझे प्राथमिक विधि कोर (!) Method_missing का विवरण नहीं मिला, लेकिन किसी अन्य स्रोत में - कृपया किसी कारण से! साथ ही, संबंधित, समान विधियों का कोई क्रॉस-रेफरेंस नहीं है।

और यह सब PHP प्रलेखन के साथ कैसे भिन्न होता है। यहां आपके लिए एक साइट है, यहां आप सभी दस्तावेज पा सकते हैं - भाषा, कार्यों और क्रॉस-संदर्भों का विवरण। मुझे याद है कि मैंने PHP में कैसे लिखना शुरू किया था - मैंने बस साइट खोली और, कदम से कदम, भाषा को स्वयं शोध करना शुरू कर दिया, जिस तरह से कार्यों के बारे में सीखना। बस प्यारी! खरोंच से एक महीने के लिए, मैंने बिना किसी समस्या के एक छोटी सी साइट लिखी।

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

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

जहां तक ​​मैंने अपने अनुभव से देखा है (मैं आईटी उद्योग में 20 से अधिक वर्षों से रहा हूं), सुविधाजनक और सस्ती प्रणालियां अक्सर जीतती हैं, और अच्छा, सुविधाजनक प्रलेखन होना लगभग आधी सफलता है, न कि उन प्रणालियों में जहां सब कुछ अंदर शांत है, लेकिन एक बाहरी पर्यवेक्षक के लिए। स्पष्ट नहीं, और कोई बताने वाला नहीं।

यहाँ, वास्तव में, मेरे विचार। PHP, रूबी, पायथन, सी ++, जावा - मशीन के साथ संवाद करने का केवल एक तरीका है, इससे ज्यादा कुछ नहीं। और हम सभी भाग्यशाली हैं कि हम चुन सकते हैं कि क्या लिखना है और कैसे लिखना है। लेकिन जब सिस्टम किसी भी उपयोगकर्ता या प्रोग्रामर के लिए आसान अध्ययन के लिए खराब पहुंच योग्य रहता है, तो प्रलेखन की कमी के पीछे छिपी सभी शीतलता की कीमत बेकार है। आपको उदाहरणों के लिए दूर नहीं जाना होगा - किसी भी विकास उपकरण की लोकप्रियता और व्यापक उपयोग केवल इसकी उपलब्धता और विशेष रूप से सुविधाजनक और पूर्ण प्रलेखन की उपलब्धता का परिणाम है।

तुरंत एक आरक्षण करें कि मंचों की उपस्थिति या जानकारी के अन्य विवादित स्रोतों की उपस्थिति मैं प्रलेखन पर विचार नहीं करता हूं। कोई भी शक्तिशाली प्रणाली होनी चाहिए, सबसे पहले, पूर्ण और सुविधाजनक दस्तावेज। और, मुझे लगता है, कई लोग मुझसे सहमत होंगे कि अपना कीमती समय स्रोत कोड पर शोध करने में खर्च करना, व्यापार करने के बजाय, सबसे सुखद और उपयोगी व्यायाम नहीं है। स्रोत कोड जानने के लिए यह निश्चित रूप से अच्छा है - यह सब कुछ उसी तरह विकसित करता है, लेकिन मेरे पास करने के लिए बहुत कुछ है, और रूबी डेवलपर्स पर रूबी और रूबी के लिए समय है कि वे अच्छे प्रलेखन के बारे में सोचें, अन्यथा ऐसे उत्कृष्ट विकास उपकरण पिछड़ जाएंगे।