इस पेज पर, तकनीकी लेखन वाले उस प्रोजेक्ट की जानकारी दी गई है जिसे Google Season of Docs के लिए स्वीकार किया गया है.
प्रोजेक्ट की खास जानकारी
- ओपन सोर्स संगठन:
- PostgreSQL
- टेक्निकल राइटर:
- लू
- प्रोजेक्ट का नाम:
- शुरुआती ट्यूटोरियल
- प्रोजेक्ट की अवधि:
- स्टैंडर्ड अवधि (तीन महीने)
प्रोजेक्ट का विवरण
शुरुआती लोगों के लिए, PostgreSQL इंस्टॉल करने और सेटअप करने का अनुभव बेहतर बनाने के लिए, शुरुआती ट्यूटोरियल को अपडेट किया गया. (https://www.postgresql.org/docs/current/tutorial-start.html)
PostgreSQL के बुनियादी बातों के चैप्टर को PostgreSQL के ट्यूटोरियल के बारे में बेहतर जानकारी दें (https://www.postgresql.org/docs/current/tutorial-arch.html). इन चीज़ों पर ज़्यादा ध्यान दिया जा सकता है: क्लाइंट-सर्वर आर्किटेक्चर, psql, क्लाइंट के उदाहरण के तौर पर इस ट्यूटोरियल में इस्तेमाल किया जाना है, PostgreSQL के कॉन्टेक्स्ट में ""क्लस्टर"" शब्दावली, डीबी बनाम ओएस उपयोगकर्ता, और मालिकाना हक.
इंस्टॉलेशन ट्यूटोरियल को अपडेट करें (https://www.postgresql.org/docs/current/tutorial-install.html).
- सोर्स और बाइनरी इंस्टॉल, दोनों के विकल्प दिखाएं. https://www.postgresql.org/download/ का रेफ़रंस जोड़ें. यहां बाइनरी इंस्टॉल करने के कम से कम निर्देश दिए गए हैं.
- अगर बाइनरी इंस्टॉल करने के निर्देशों में कोई अंतर है, तो उन्हें पहचानें और वेबसाइट को बड़ा करें या दस्तावेज़ में उनका समाधान करें.
- इस बात पर भरोसा न करें कि उपयोगकर्ता, सोर्स इंस्टॉल करने के बारे में पूरा चैप्टर पढ़कर, इसे समझ लेंगे: इंस्टॉल करने के बाद ज़रूरी मुख्य चरणों के बारे में बताएं. जैसे, क्लस्टर को शुरू करना और सर्वर को अपने-आप शुरू करना. ज़्यादा जानकारी के लिए, दस्तावेज़ के खास चैप्टर के लिंक दें.
- अगर कम्यूनिटी ने किसी खास ओएस के लिए डिफ़ॉल्ट सेटिंग और सबसे सही तरीकों के बारे में जानकारी दी है, तो उससे जुड़े संसाधनों के लिंक भी जोड़ें.
https://www.postgresql.org/docs/current/tutorial-createdb.html को बेहतर बनाएं
- जहां भी हो सके, ""एडमिन से संपर्क करें"" निर्देशों को हटा दें. साथ ही, इस बात पर भरोसा करके काम के समाधान दें कि उपयोगकर्ता ने ट्यूटोरियल को सिलसिलेवार तरीके से पूरा किया है.
https://www.postgresql.org/docs/current/tutorial-accessdb.html को बेहतर बनाएं
- पुष्टि करने से जुड़ी बुनियादी समस्याओं और आसान pg_hba.conf उदाहरणों के बारे में बताना
दस्तावेज़ में यह बदलाव करने के लिए, मेरा मकसद Windows और Ubuntu पर मौजूद ट्यूटोरियल को आज़माना है. साथ ही, सेटअप से जुड़ी बार-बार होने वाली समस्याओं के लिए फ़ोरम ब्राउज़ करना है. इसके अलावा, मैं यह पक्का करने के लिए मेंटर से सलाह भी लूंगा कि मुझे सबसे सही तरीके मिलें और सबसे अहम कॉन्सेप्ट को आसानी से समझाया जा सके.