इस पेज पर, तकनीकी लेखन वाले उस प्रोजेक्ट की जानकारी दी गई है जिसे Google Season of Docs के लिए स्वीकार किया गया है.
प्रोजेक्ट की खास जानकारी
- ओपन सोर्स संगठन:
- Qubes OS
- टेक्निकल राइटर:
- c1e0
- प्रोजेक्ट का नाम:
- समस्या हल करने से जुड़ी गाइड को एक साथ रखना
- प्रोजेक्ट की अवधि:
- स्टैंडर्ड लंबाई (तीन महीने)
प्रोजेक्ट का विवरण
ABSTRACT
समस्या का हल बताने वाली गाइड को असली उपयोगकर्ताओं के लिए बनाया गया है, ताकि वे प्रॉडक्ट या सेवा का इस्तेमाल करते समय आने वाली किसी भी समस्या को हल कर सकें. समस्या हल करने के लिए बनी गाइड ज़रूरी है, क्योंकि इससे समस्या होने पर उपयोगकर्ताओं को मदद मिलती है. इससे, किसी समस्या का सामना करने पर उपयोगकर्ता किसी प्रॉडक्ट को खरीदने से नहीं हटते. दुनिया भर में हर दिन, Qubes का इस्तेमाल करने वाले हज़ारों लोग हैं. इनमें से कई लोगों को किसी न किसी समय कोई समस्या आ सकती है. ऐसे में, समस्या हल करने से जुड़ी गाइड से उन्हें फ़ायदा मिलेगा.
समस्या हल करने वाली गाइड की मौजूदा स्थिति
फ़िलहाल, QubesOS से जुड़ी समस्या हल करने के लिए गाइड, कई पेजों पर मौजूद हैं. साथ ही, ये गाइड कभी-कभी अधूरी होती हैं. इस वजह से, उपयोगकर्ताओं को समस्याओं का पता लगाने में मदद करते समय, एक ही निर्देश को बार-बार पोस्ट करना पड़ता है. उपलब्ध गाइड में, समस्या के लक्षण और कार्रवाई का लेआउट नहीं है. इससे, उपयोगकर्ता के लिए किसी समस्या को उसके समाधान से मैच करना मुश्किल हो जाता है. इसके अलावा, कुछ समस्याओं के बारे में सोशल मीडिया (Reddit), Qubes के GitHub पर समस्याओं के पेज, और #qubes-users फ़ोरम पर बार-बार बताया गया है. हालांकि, समस्या हल करने से जुड़ी मौजूदा गाइड में इन समस्याओं के बारे में नहीं बताया गया है.
समस्या हल करने वाली मेरी बताई गई गाइड में, मौजूदा समस्या की तुलना में सुधार क्यों है?
समस्या हल करने के लिए दी गई मेरी गाइड पूरी होगी. इसे इस तरह से व्यवस्थित किया गया है कि यह पक्का किया जा सके कि जानकारी सटीक और आसान है. इस गाइड में, समस्या को हल करने के बारे में सिलसिलेवार निर्देश दिए गए हैं. इसमें समस्या और कार्रवाई का लेआउट होगा. इसमें समस्या के बारे में बताया जाएगा और उसके बाद, उस समस्या को हल करने का सुझाव दिया जाएगा. समस्या हल करने के तरीके, सर्च इंजन के हिसाब से ऑप्टिमाइज़ किए जाएंगे. साथ ही, इनमें उन समस्याओं को ध्यान में रखा जाएगा जिन्हें उपयोगकर्ता सोशल मीडिया और सर्च इंजन पर खोज रहे हैं. इन सभी बदलावों से यह पक्का किया जा सकेगा कि उपयोगकर्ता, समस्या हल करने से जुड़ी आधिकारिक गाइड को सर्च इंजन से ढूंढ सकें. साथ ही, वे अपनी समस्याओं का हल तुरंत/आसानी से ढूंढ सकें
समस्या हल करने के लिए सुझाई गई गाइड का स्ट्रक्चर और समयसीमा
मैंने Qubes OS से जुड़ी समस्या हल करने के लिए, गाइड का एक प्रस्तावित स्ट्रक्चर बनाया है. इसे यहां देखा जा सकता है: https://docs.google.com/document/d/187NlnEvctYVVUnRuGtwY2PkYBVxBSSPfpSwZEaczqL8/edit?usp=sharing. लेआउट के साथ एक अनुमानित समयसीमा दी जाती है. इस दौरान समस्या हल करने से जुड़ा हर सेक्शन लिखा जाएगा. मेंटर से सुझाव मिलने के बाद, यह लेआउट लागू किया जाएगा. मेंटर के सुझाव या राय के आधार पर, स्ट्रक्चर और समयसीमा में बदलाव किया जा सकता है.
प्रोजेक्ट के लक्ष्य
- समस्या हल करने वाली गाइड को फिर से तैयार करें, ताकि लोगों को समस्याओं के बारे में बताने वाली कार्रवाई का लेआउट बेहतर तरीके से समझा जा सके और उसे समझा जा सके.
- समस्या हल करने के मौजूदा तरीकों को फिर से लिखें, ताकि सिलसिलेवार निर्देशों को आसानी से समझा जा सके.
- जहां ज़रूरी हो वहां स्क्रीनशॉट जोड़ें
- Qubes को खुद इंस्टॉल करके आज़माएं और आने वाली समस्याओं को रिकॉर्ड करें. मेरे पास तीन कंप्यूटर हैं: Lenovo Thinkpad, Dell Latitude, और Acer Aspire. हम इन सभी कंप्यूटर पर Qubes को आज़माएंगे. साथ ही, किसी भी गड़बड़ी को रिकॉर्ड करेंगे और समस्या हल करने के तरीकों की पुष्टि करेंगे.
- मौजूदा गाइड में मौजूद पुरानी जानकारी हटाएं.
- पक्का करें कि समस्याएं सही तरीके से हल की गई हों. फ़िलहाल, समस्या हल करने वाली मौजूदा गाइड में गड़बड़ी का मैसेज ""यह गैर-आधिकारिक, तीसरे पक्ष का दस्तावेज़ है. Qubes OS Project इस पेज के सटीक होने की गारंटी नहीं दे सकता. कृपया सावधानी बरतें"". समस्या हल करने के निर्देशों की पुष्टि होने के बाद, यह चेतावनी हटा दी जाएगी. वे सही हैं या नहीं, यह पक्का करने के लिए मेरे पीसी पर समस्या हल करने वाले टूल की व्यक्तिगत तौर पर जांच की जाएगी (अगर मुमकिन हो) या ऑनलाइन जांच करके यह देखा जाएगा कि किसी उपयोगकर्ता ने समाधान की पुष्टि की है या नहीं.
- समस्या हल करने से जुड़ी किसी भी बाहरी जानकारी को (फ़ोरम और GitHub से) समस्या हल करने के आधिकारिक वेबपेज पर माइग्रेट करें.
- Reddit (r/QubesOS), Stack Exchange, #qubes-users Google ग्रुप, और GitHub से जुड़ी समस्याओं के बारे में रिसर्च करें और जानें कि उपयोगकर्ताओं को कौनसी समस्याएं आ रही हैं. मैं Keywordtool.io और UberSuggest.com जैसे कीवर्ड रिसर्च टूल का भी इस्तेमाल करूंगा. इससे मुझे यह पता चलेगा कि Google जैसे सर्च इंजन पर अक्सर किन सवालों को खोजा जाता है.
- अगर समस्या हल करने वाली गाइड से उपयोगकर्ताओं की समस्या का समाधान नहीं होता है, तो “मदद पाना” सेक्शन जोड़ें. Fedora के समस्या हल करने वाले पेज पर इसका एक उदाहरण देखा जा सकता है: https://docs.fedoraproject.org/en-US/fedora/rawhide/install-guide/install/troubleshooting/#sect-troubleshooting- Get-help.
यह प्रोजेक्ट ही क्यों?
मुझे टेक्नोलॉजी, खास तौर पर सायबर सुरक्षा और निजता से जुड़ी चीज़ें बहुत पसंद हैं. मुझे लगता है कि लिखना मेरी सबसे बड़ी ताकत है. मेरी दिलचस्पी खास तौर पर Qubes OS में है, क्योंकि इसमें मेरी दो मुख्य दिलचस्पी शामिल हैं: सुरक्षा और निजता. मैं सुरक्षा और निजता पर फ़ोकस करने वाले अन्य प्रॉडक्ट का नियमित तौर पर इस्तेमाल करता/करती हूं. जैसे, DuckDuckGo और Tor. मैंने हाल ही में Qubes OS के बारे में जाना है और मुझे यह बहुत पसंद आ रहा है.
मुझे क्यों लगता है कि मैं इस प्रोजेक्ट के लिए सही व्यक्ति हूं
- मुझे सुरक्षा, निजता, और अच्छे/काम के दस्तावेज़ लिखने में दिलचस्पी है.
- मुझे Qubes OS को इंस्टॉल और इस्तेमाल करने में समस्याएं आई हैं. इसलिए, समस्या हल करने के निर्देशों में इन समस्याओं के बारे में बेहतर तरीके से बताया जा सकता है.
- मैंने पिछले महीने, Qubes ऑपरेटिंग सिस्टम के तकनीकी पहलुओं के बारे में पढ़ाई की है. मैंने Qubes OS के दस्तावेज़ों को भी अच्छी तरह से पढ़ा है. दस्तावेज़ में बदलाव करने की प्रोसेस को समझने के लिए, मैंने एक पुल अनुरोध (https://github.com/QubesOS/qubes-doc/pull/1005/files) बनाया है
- मैंने हाल ही में Tor प्रोजेक्ट में इंटर्नशिप की है. मेरी भूमिकाएं, तकनीकी सहायता और लेखन थीं. हेल्पडेस्क पर काम करते समय, मुझे उन उपयोगकर्ताओं से सैकड़ों सवाल मिले जिन्हें Tor Browser को इंस्टॉल या इस्तेमाल करने में समस्याएं आ रही थीं. इन उपयोगकर्ताओं की समस्याओं को हल करने में उनकी मदद करके, मुझे समस्या हल करने के लिए कम शब्दों में और आसान निर्देश लिखने का तरीका पता चला
- Tor Project में काम करते समय, मैंने Markdown का इस्तेमाल करके तकनीकी दस्तावेज़ भी लिखे हैं. मैंने वर्शन कंट्रोल के लिए, Git, GitHub, और GitLab का इस्तेमाल किया.