डेवलपर्स के लिए Technical Writing की 10 आज्ञाएँ
(tech-kakaoenterprise.tistory.com)-
आवश्यक वाक्य घटकों को न छोड़ें
-
वाक्य घटकों के बीच सामंजस्य बनाए रखें
-
विभक्ति चिह्नों का सही उपयोग करें
-
कर्मवाच्य/प्रेरणार्थक रूपों से बचें
-
दोहरे निषेध से बचें
-
स्पष्ट अभिव्यक्तियों का उपयोग करें
-
क्रम और सूची में अंतर करें
-
बुलेट-स्टाइल लेखन का उपयोग करें
-
वर्तनी/स्पेसिंग की जाँच करें
-
विदेशी शब्दों की वर्तनी की जाँच करें
2 टिप्पणियां
टेक्निकल राइटिंग के 4 प्रमुख सिद्धांत https://hi.news.hada.io/topic?id=5409
संपादन की कला - डेवलपर्स के लिए तकनीकी दस्तावेज़ लेखन विधि https://hi.news.hada.io/topic?id=5446
प्रोग्रामर के मामले में विदेशी शब्दों की वर्तनी के लिए व्यावहारिक रूप से सिर्फ़ English पर ध्यान देना होता है, लेकिन यह याद रखें कि कोरियाई विदेशी शब्द वर्तनी नियम spelling नहीं बल्कि वास्तविक उच्चारण पर आधारित होते हैं, और English की spelling अक्सर उच्चारण को ठीक से नहीं दर्शाती, इसलिए शब्द की spelling नहीं बल्कि उसके pronunciation symbols देखकर रूपांतरित करने से गलतियाँ कम होती हैं.
अगर ठीक से समझ न आए तो 1) कोरियाई शब्दकोश में उस English शब्द को सीधे खोजें; अगर वह मिल जाए तो वही इस्तेमाल करें, और 2) अगर न मिले तो English dictionary में वह शब्द खोजकर International Phonetic Alphabet (IPA) देखकर उसकी वर्तनी का अनुमान लगाया जा सकता है. हालांकि, विदेशी शब्द वर्तनी नियम English के लिए British pronunciation को आधार मानते हैं, इसलिए कभी-कभी अप्रत्याशित वर्तनी भी सामने आ सकती है.
अगर भाषा English नहीं है, तो Hangulize(https://hangulize.org/) जैसी चीज़ इस्तेमाल करना सुविधाजनक है, लेकिन English की spelling इतनी अव्यवस्थित है कि उसे इस तरह यांत्रिक तरीके से लागू करना मुश्किल है, और कहा जाता है कि शब्दकोश ज़रूरी होता है. (नए गढ़े गए शब्दों के मामले में वे शब्दकोश में दर्ज नहीं होते, इसलिए कभी-कभी YouTube जैसी जगहों पर यह देखना पड़ता है कि लोग उस शब्द का उच्चारण कैसे कर रहे हैं.)