👩🏽‍🚀 ♍️ 🌑 हम हबर पर लेख कैसे लिखते हैं: ईस्टबैंक टेक्नोलॉजीज डेवलपर्स का अनुभव 🏎️ 🔉 🔶

हाल ही में, दो लेख पहले, हमारे कॉर्पोरेट हब में एक सौवां लेख प्रकाशित हुआ था। गोल संख्या के सम्मान में, हमने अपने अनुभव को थोड़ा संक्षिप्त करने का निर्णय लिया। इस लेख में, हम बताएंगे कि हमारे डेवलपर्स लेखों पर कैसे काम करते हैं, जो उन्हें लिखने में मदद करता है और पाठ पर काम करते समय क्या ध्यान देना चाहिए।

शुरू करने के लिए, बस दो आसान सवालों के जवाब दें:

मुझे इसकी आवश्यकता क्यों है?
मैं हैबरा-समुदाय को दिलचस्प और उपयोगी क्या बताऊंगा?

फिर आप इस लेख से योजना ले सकते हैं (या अपने खुद के साथ आ सकते हैं) और इसे करें।

रचनात्मक और तकनीकी चरण हैं। यह लेख रचनात्मक के बारे में है। पर विचार करें:

लेख क्यों लिखते हैं?
जहां लेख के लिए विषय प्राप्त करने के लिए,
इसे लिखने के लिए समय कहां मिलेगा,
पाठ पर काम के मुख्य चरण,
यदि लेख नहीं जाता है, तो क्या करें
और जहां अगर आपने कभी हबर में नहीं लिखा है, तो कहां से शुरू करें।

हम आशा करते हैं कि पाठ संभावित लोगों सहित अन्य हैबर लेखकों के लिए उपयोगी होगा।

प्रेरणा: मुझे एक डेवलपर के रूप में क्यों होना चाहिए, हैबर में लिखें

एक भी उत्तर नहीं है और कोई चांदी की गोली नहीं है। इसलिए, हम अपने कर्मचारियों के जवाब देते हैं, जहां हर कोई खुद को पहचान सकता है, और हम खुशी के साथ सुनेंगे, जैसा कि आपके पास है।

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

हैबर के लिए उपयोगिता पर विचार करने वाले विषय का चुनाव

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

अच्छे विषय

ऐसे समाधान हैं जिनके बारे में डेवलपर्स कहते हैं: “इस बारे में कोई आधिकारिक दस्तावेज नहीं था, हैबे पर भी। मुझे टिंकर करना था। ” यदि निर्णय स्वयं सभ्य है, तो लेख अच्छा होगा।
कुछ विषय परियोजना द्वारा प्रस्तुत वैश्विक चुनौती से उपजी हैं - उदाहरण के लिए, उच्च उपलब्धता और पारदर्शी CI / CD प्रदान करने के लिए। इस लक्ष्य की ओर प्रत्येक कदम - .Net कोर, डॉकर और इतने पर प्रवास - को एक अलग लेख में वर्णित किया जा सकता है। रैलियों में, एक मजाक "एक लेख में!" अक्सर स्किप हो जाता है, अर्थात। सहकर्मियों जैसे कि इशारा करना।
विषय का एक हिस्सा तब आता है जब आप सक्रिय रूप से एक नए विषय पर शोध करते हैं। एक संकेत है: यदि डेवलपर ने Google पर शोध करने या अन्य लेखों को पढ़ने में 4 घंटे से अधिक समय बिताया है, तो यह कम से कम मिली जानकारी को संकलित करने या शायद कुछ नया लिखने के लिए सार्थक है।
कुछ ग्रंथ एक दिलचस्प किताब पढ़ने के बाद पैदा होते हैं, एक अच्छे सम्मेलन में भाग लेने या यहां तक कि आंतरिक प्रलेखन के रूप में - मैं नए ज्ञान को साझा करना चाहता हूं।

जो लाभकारी है वह अच्छा है, भविष्य में पाठकों के लिए समय बचाता है और विश्व शांति के बारे में दार्शनिक अटकलों के बजाय व्यावहारिक अनुभव देता है।

खराब विषय

उनमें से कई महान हैं, लेकिन हम उनमें से कुछ का उल्लेख करेंगे:

कीवर्ड द्वारा अनुक्रमित करने के एकमात्र उद्देश्य के लिए जाना जाता है,
किसी कंपनी या क्लाइंट का प्रत्यक्ष या अप्रत्यक्ष विज्ञापन (देखें कि मैं किसके साथ काम करता हूं),
कुछ भी नहीं या विचारों की संरचनाहीन धारा के बारे में एक लेख।

सामान्य तौर पर, सब कुछ बुरा है जो पाठक को लाभ नहीं देता है या उसका सम्मान नहीं करता है।

पाठ पर काम के मुख्य चरण

लेखक के लिए, ग्रंथों पर काम 6 रचनात्मक चरणों से गुजरता है:

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

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

और अब योजनाओं से लेकर कार्रवाई तक। यानी पाठ को।

बहुत सारे कार्य: पाठ पर काम करने का समय कैसे निकालें

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

हमारे एक लेखक ने इस काम की तुलना परीक्षणों से की। पहले तो आप सोचते हैं कि परीक्षण लिखने का समय नहीं है। फिर आप इस गतिविधि को प्रक्रिया में एम्बेड करते हैं - और यह पता चलता है कि समय है। ग्रंथ, परीक्षणों की तरह, यह समझने में मदद करते हैं कि क्या हो रहा है। यहां तक कि अगर आप दिन में प्रति घंटे लेख को आवंटित करते हैं, तो यह काम करेगा। बेशक, अगर यह किसी व्यक्ति के लिए महत्वपूर्ण है।

एक और सुबह सख्ती से लिखता है। पहली बात पहले। यह जानते हुए कि उसके पास बहुत से मुख्य काम हैं, वह काम के दिन की शुरुआत से पाठ पर 20 मिनट खर्च कर सकता है। ऐसी परिस्थितियों में, यह स्पष्ट रूप से, संक्षिप्त रूप से और मामले पर लिखना है।

मैं हैबर पर एक लेख लिखना चाहता हूं और यहां तक कि एक विषय के साथ आया हूं। कहाँ से शुरू करें?

इस समस्या में कोई नई बात नहीं है। स्टीफन किंग, जॉर्ज ऑरवेल, एडगर एलन पो, स्ट्रगैट्सस्की कामरेड, युगल हेनरी लियोन ओल्डी, रिचर्ड फेनमैन और कई अन्य लेखकों ने एक रूप में या किसी अन्य ने कहा:

"यदि आप कुछ शुरू करना चाहते हैं (एक लेख, एक किताब या एक दोस्त को एक पत्र लिखने के लिए), लेकिन आप अभी भी ऐसा नहीं कर सकते हैं - इससे बेहतर करने के लिए कोई समय और स्थिति नहीं है ... अभी!"

हम में से एक पाठ संपादक खोलने और वहाँ विषय पर विचारों की एक धारा डालने में मदद करता है। सबसे अधिक संभावना है, तो यह पता चला है कि यह "सभी गलत है", लेकिन पहला कदम उठाया गया है - लेख पर काम शुरू हो गया है।

एक और तरीका है: किसी अन्य कर्मचारी को खोजने और उसे लेख के विषय के बारे में बताने के लिए। और कहानी को शब्दों के साथ शुरू करने के लिए: "ठीक है, संक्षेप में ..."। और जैसे ही पहला विचार डाला, "धन्यवाद!" अपने आप से भाग जाओ और तत्काल अपनी कहानी लिखो। सरल शब्दों में, उत्पादन मैट के साथ, जिसे आप तब कुछ रचनात्मक के साथ बदलते हैं।

और नाश्ते के लिए, क्लासिक से रास्ता आपकी जिम्मेदारी के तहत कड़ाई से है।

मैं लिख रहा हूं, मैं लिख रहा हूं, मैं फंस गया हूं। क्या करें?

तीन परिदृश्य हैं जिन्हें स्थिति पर लागू किया जा सकता है:

एक कप चाय लें और आराम करें। जब पाठ "नहीं जाता है" तो आपको निश्चित रूप से अपने आप को मजबूर करने की आवश्यकता नहीं है - इस तरह के अतिव्यापी से अच्छा कुछ भी नहीं होता है। यह, संयोग से, केवल लेख लिखने के बारे में नहीं है।

लेकिन नौकरी फेंकना इसके लायक नहीं है। जैसे ही आपको लगता है कि आप कम या ज्यादा आराम से हैं - जो कुछ लिखा गया है उसे फिर से पढ़ें, निश्चित रूप से कुछ और विचार दिमाग में आएंगे। पाठ संरचना की रूपरेखा तैयार करें। किसी सहकर्मी को टेक्स्ट फेंक दें।

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

यदि आपके पास अन्य विकल्प हैं, तो रचनात्मक स्तूप से बाहर कैसे निकलें - टिप्पणियों में साझा करें।

निष्कर्ष में

लिखें। किसी की न सुनें और लिखें। यह अच्छा है। और आप अच्छी तरह से लिखेंगे - आम तौर पर उत्कृष्ट। और फिर हब्बर-समुदाय स्मार्ट, कसम खाएंगे और अमीर होंगे।

अंत में, इस विषय के उपयोगी लिंक:

Mail.ru कंपनी के ब्लॉग के लिए संलेखन सामग्री बनाने के बारे में लेख
उपयोगी पुस्तक "लिखें, संक्षिप्त करें" और समझ के लिए एक्सप्रेस टेक्स्ट की जांच के लिए एक साइट
चुनिंदा लेख

टिप्पणियों में अपने व्यंजनों को साझा करें, प्रतीक्षा करें!

हम हबर पर लेख कैसे लिखते हैं: ईस्टबैंक टेक्नोलॉजीज डेवलपर्स का अनुभव