Typescript: टाइपस्क्रिप्ट वेबसाइट और दस्तावेज़ीकरण के बारे में आपको क्या पसंद नहीं है?

"उपयोगिता प्रकार" पृष्ठ अप-टू-डेट नहीं है

नए उपयोगिता प्रकार अक्सर छूट जाते हैं या हैंडबुक के "उपयोगिता प्रकार" पृष्ठ में नहीं जोड़े जाते हैं (उदाहरण Parameters<T> )। मुझे अक्सर हैंडबुक के बजाय lib.es5.d.ts ब्राउज़ करने का सहारा लेना पड़ता है।

टैग: docs

आधिकारिक टाइपस्क्रिप्ट खेल का मैदान ओपन-सोर्स विकल्पों जितना अच्छा नहीं है

https://typescript-play.js.org आधिकारिक की तुलना में बेहतर काम करता है: इसमें टाइपस्क्रिप्ट के कई संस्करण शामिल हैं, बड़े टेक्स्ट साझा करने की अनुमति देता है, यह सभी कंपाइलर फ़्लैग का समर्थन करता है और डिफ़ॉल्ट रूप से सख्त मोड चालू है।

टैग: playground

रिलीज नोट्स के लिए इंडेक्स पेज का अभाव

मेरी इच्छा है कि इस यूआरएल के तहत सभी पिछले रिलीज नोट्स सूचीबद्ध करने के लिए एक इंडेक्स पेज होगा: https://www.typescriptlang.org/docs/handbook/release-notes । इस तरह, हम टाइपस्क्रिप्ट पर पिछले रिलीज़ अपडेट का ट्रैक रख सकते हैं।

टैग: docs , release notes

प्रकार के नामों की शब्दावली नहीं है

यदि आपने const a: "foo" | "bar" जैसा कोई कोड पास किया है, तो हो सकता है कि आप इसे यूनियन टाइप कहना न जानते हों।

यह एक बहुत कम बार है, लेकिन जब हम अस्तित्वगत/सशर्त/मैप्ड/आदि प्रकारों के बारे में बात करना शुरू करते हैं तो उस पृष्ठ पर जाने में सक्षम होना अच्छा होता है जो इसे परिभाषित करने का प्रयास करता है, लेकिन इसे गहराई से दस्तावेज नहीं करता है ताकि आप एक सिंहावलोकन प्राप्त कर सकें इस भाषा के लिए सभी वर्गीकरण का

टैग: types , handbook

गैर-तकनीकी लोगों के साथ साझा करने के लिए कोई पेज नहीं है

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

टैग: guides

निश्चित रूप से टाइप किया गया दस्तावेज़ टाइपस्क्रिप्ट दस्तावेज़ों के बाहर रहता है और पुराना है

टाइपस्क्रिप्ट प्रोजेक्ट के पास इसके आसपास के दस्तावेज़ होने चाहिए। निश्चित रूप से टाइप किए गए के लिए प्रलेखन इसमें रहता है:

• https://निश्चित रूप से typed.org
• https://github.com/DefinitelyTyped/DefinitelyTyped#how -can-i-contribute

TS डॉक्स में इसका एक सिंहावलोकन हो सकता है कि यह क्या है, इसका उपयोग क्यों किया जाता है और हम आधिकारिक साइट को हटा सकते हैं

टैग: definitely-typed

उत्तरोत्तर TS . नहीं सिखाता है

(अधिक पठनीयता के लिए संपादित) मुझे लगता है कि दस्तावेज़ सबसे प्रभावी होते हैं जब उनके पास एक स्पष्ट "व्यक्तित्व" होता है जिसके लिए वे हैं। जब ये दस्तावेज़ बनाए गए थे, तब ES6 कोई चीज़ नहीं थी। जब ये दस्तावेज़ बनाए गए थे, तो आप दोपहर में सभी TS सीख सकते थे।

समय बदल गया है।

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

विशेष रूप से यहाँ उन व्यक्तियों की एक विस्तृत सूची है जिन पर विचार किया जाना चाहिए जो एक प्रगतिशील शिक्षक के रूप में काम कर सकते हैं:

• जो लोग सिर्फ JSDoc के साथ TS का उपयोग करना चाहते हैं, कोई बिल्ड स्टेप नहीं है
• जो लोग बिना कोई जेनरिक लिखे TS का अधिक से अधिक उपयोग करना चाहते हैं
• जो लोग कोडबेस को JS/Flow से TS में माइग्रेट कर रहे हैं
• जो लोग TS में नए हैं, उन्होंने TS को अपनाया है, लेकिन पहली बार अपरिचित, वर्बोज़ त्रुटियां देखते हैं और यह नहीं जानते कि इससे कैसे निपटा जाए (यह " समस्या निवारण " ऑडियंस है) या इससे ऑप्ट आउट करें
• जो लोग TS लाइब्रेरी बनाम TS ऐप्स प्रकाशित करना चाहते हैं
• जो लोग टाइप ऑपरेटरों का उपयोग करना सीखना चाहते हैं
• जो लोग टाइप यूटिलिटीज के बारे में सीखना चाहते हैं जो उनकी मदद कर सकते हैं
• जिन लोगों को टाइप न किए गए पुस्तकालयों को टाइप करने की आवश्यकता होती है (यह बहुत अधिक नेटवर्क प्रभाव है और टीएस की रुचि .d.ts लेखन को हास्यास्पद रूप से आसान और यथासंभव अच्छी तरह से प्रलेखित करने के लिए है)
• और आआआआआआआआआल अंत में, जो लोग सीखना चाहते हैं कि अपना सामान्य प्रकार तर्क कैसे लिखना है
• (हो सकता है) वे लोग जो TS AST को पार करने के लिए आवश्यक प्लगइन्स लिखना चाहते हैं

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

मुझे लगता है कि डॉक्स इस मिथक को दूर करने में मदद करने के लिए बहुत कुछ कर सकते हैं कि:

• आपको हर समय अधिकतम प्रकार की सुरक्षा की आवश्यकता होती है (न केवल tsconfig में, बल्कि उन विकल्पों में भी जो हम टाइपिंग कार्यों में करते हैं)
• TS OO प्रोग्रामर्स के लिए है (हाँ, मैंने इसे देखा है)
• टीएस केवल सी #/जावा देवों के लिए है जो जेएस में आते हैं और मिस टाइप करते हैं, इसका जेएस देवों के लिए कोई वास्तविक मूल्य नहीं है
• आपको यह पता लगाने में सक्षम होना चाहिए कि TS त्रुटियों को स्वयं कैसे हल किया जाए
• सामान्य तौर पर, कि TS के पास आरंभ करने के लिए एक उच्च सीखने की अवस्था है

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

यह शायद देर से चरण टीएस अपनाने के लिए एक बड़ी बाधा है (यानी जिन लोगों को टीएस पर बेचे जाने के लिए अधिक दस्तावेज़/उपकरण/आश्वासन/हैंडहोल्डिंग की आवश्यकता होती है) जैसा कि मैं कल्पना कर सकता हूं।

टैग: docs

लिंक्ड टाइपस्क्रिप्ट भाषा विशिष्टता पूरी तरह से पुरानी है

सीधे मुख्य पृष्ठ पर आप "टाइपस्क्रिप्ट भाषा विशिष्टता" से लिंक कर रहे हैं।

GitHub पर विनिर्देश पढ़ें या इसे docx या pdf के रूप में डाउनलोड करें।

हालांकि, वह विनिर्देश पूरी तरह से पुराना है (संस्करण 1.8 पर अटका हुआ है, जनवरी 2016 में अंतिम वास्तविक अपडेट), और इसे बनाए नहीं रखा गया है। विनिर्देश के किसी भी उल्लेख को छोड़ देना सबसे अच्छा होगा।

टैग: spec specification outdated

कोड नमूने के लिए खेल का मैदान जैसा विजेट

सभी सुविधाजनक टूलटिप्स, हाइलाइट्स आदि के साथ खेल के मैदान जैसे विजेट में डॉक्स में सभी कोड नमूने प्रस्तुत करें।

आदर्श रूप से उत्सर्जित जेएस/टाइपिंग को संपादित करने और देखने के साथ, एक पूर्ण खेल के मैदान में पॉप आउट करने की क्षमता के साथ।

यह स्वाभाविक रूप से आधिकारिक टाइपस्क्रिप्ट प्लेग्राउंड पर निर्भर करेगा, यह जितना अच्छा नहीं है ।

एपीआई दस्तावेज जो केवल रिलीज नोट्स में मौजूद है

कुछ प्रकार, जैसे unknown , केवल रिलीज नोट्स में प्रलेखित

टैग: docs

फोरस्लैश खेल का मैदान

/tests/cases/compiler में बहुत सारी फाइलें हैं, जो बेसलाइन के साथ मिलकर क्रिप्टिक डार्क मैटर की तरह व्यवहार करती हैं। इन मेगाबाइट्स को डॉक्स/डेमो के रूप में पुन: उपयोग किया जा सकता है।

• टीएस खेल के मैदान को टीएस रेपो से किसी भी फाइल को कुछ इस तरह से लोड करें :
• टीएस खेल के मैदान को 'फोरस्लैश' समझें
• उन फाइलों में वर्णनात्मक टिप्पणियां जोड़ें

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

खेल का मैदान जो किसी दिए गए TS सिंटैक्स की व्याख्या करता है

एक जटिल टीएस सिंटैक्स पर ठोकर खाना मुश्किल नहीं है जिसे समझना वाकई मुश्किल है। रिकर्सिव जेनरिक, यूनियनों और फंकी अनुक्रमित प्रकारों के माध्यम से संयुक्त ... उदाहरण के लिए, ऐसे डरावने सेंटीपीड का एक बड़ा घोंसला टाइपिंग है।

क्या होगा यदि कोई कोण-समृद्ध वाक्यविन्यास का एक हिस्सा चिपकाने में सक्षम था, और वर्बोज़ मानव-पचाने योग्य दृश्य या आरेख का निरीक्षण करता था। आप जानते हैं, जहां आप निस्संदेह स्पष्ट रूप से देख सकते हैं कि A एक वर्ग है, और B एक संघ प्रकार है, और C D लिए एक सामान्य पैरामीटर है और इसी तरह।

भोले 'वर्बोज़ एएसटी सुंदर-प्रिंट' के रूप में शुरू होने से यह समय और सामुदायिक योगदान के साथ गहन पैटर्न पहचान और समृद्ध इंटरैक्टिव विजुअल और यूएमएल-जैसे आरेखों में विस्तारित हो सकता है।

दस्तावेज़ीकरण की कोई खोज नहीं है

मुझे अक्सर गुगलिंग का सहारा लेना पड़ता है कि मुख्य दस्तावेज़ को सत्य के स्रोत के रूप में रखने के बजाय टाइपस्क्रिप्ट के साथ कुछ कैसे किया जाए, उदाहरण के लिए रिएक्ट डॉक्स जैसे डॉकसर्च के साथ

टैग: search , exploration

सामुदायिक परियोजनाओं को हाइलाइट करें

यह मुलाकात, सामुदायिक वार्ता या किताबें जैसी चीजें हो सकती हैं।

लेकिन बड़े सॉफ्टवेयर प्रोजेक्ट भी हो सकते हैं जो टाइपस्क्रिप्ट का उपयोग करते हैं जिससे कोई सीख सकता है।

टैग: Community

विशिष्ट कंपाइलर फ़्लैग चालू करने के लिए मार्गदर्शिकाएँ प्रदान करें

उदाहरण के लिए अगर मुझे noImplicitReturns चालू करना है तो मैं किस प्रकार की समस्याओं का सामना करूंगा, और मुझे उन्हें कैसे संभालना चाहिए? हम उस समय के लिए संस्करण रिलीज़ नोट्स के साथ इस प्रकार की अनुशंसाओं को शिप करते हैं, और इसलिए उन्हें देखना मुश्किल है।

टैग: tsconfig

कंपाइलर एरर इंडेक्स पेज बनाएं

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

टैग: compiler

क्या होगा यदि कोई कोण-समृद्ध वाक्यविन्यास का एक हिस्सा पेस्ट करने में सक्षम था, और वर्बोज़ मानव-पचाने योग्य दृश्य या आरेख का निरीक्षण करता था

मुझे लगता है कि यह अच्छा होगा, लेकिन कुछ मामलों में मुझे लगता है कि एक प्रकार कैसे टूटता है (जो ऑटो-जेनरेट करने के लिए कुछ हद तक संभव लगता है) के बारे में एक उच्च संरचित स्पष्टीकरण प्रकार और पैटर्न के कुछ सामान्य संयोजनों को पहचानने के रूप में उपयोगी नहीं है। विशेष लक्ष्य। उदाहरण के तौर पर, मान लीजिए कि मैं चाहता हूं कि कोई यह बताए कि यह क्या है:

type X<T extends object> = {
    [K in keyof T]: T[K]
}[keyof T]

मैं आपको बता सकता हूँ कि

X एक प्रकार के पैरामीटर के साथ एक प्रकार का उपनाम है T जो object सीमित है। जब T साथ त्वरित किया जाता है, तो यह एक मैप किए गए प्रकार का उत्पादन करता है, जहां प्रत्येक घटक K प्रकार keyof T , मूल्य अनुक्रमित पहुंच प्रकार T[K] . X फिर उस मैप किए गए प्रकार पर keyof T प्रकार के साथ एक अनुक्रमित एक्सेस प्रकार उत्पन्न करता है।

लेकिन यह बहुत अधिक सहायक होगा, और फिर भी टाइपस्क्रिप्ट के कार्यसाधक ज्ञान वाले मनुष्य के अलावा किसी भी चीज़ द्वारा उत्पादन करना असाधारण रूप से कठिन होगा, आपको यह बताना:

X को T के सदस्य मूल्यों के प्रकारों का संघ मिलता है।

मुझे लगता है कि शायद इस तरह के पैटर्न के "व्यंजनों" का संग्रह आसान हो सकता है।

उन्नत प्रकार पृष्ठ किसी भी गैर-स्पष्ट प्रकार के लिए सिर्फ एक प्रकार का डंपिंग ग्राउंड है (मैंने PHP स्थिर विश्लेषण उपकरण के लिए टाइपस्क्रिप्ट के विचारों का एक गुच्छा चुरा लिया है, इसलिए मैं खुद को उस पृष्ठ पर बहुत कुछ पाता हूं)।

वहाँ विचारों का एक समूह आपस में जुड़ा हुआ है, लेकिन यह काफी हद तक पृष्ठों के बीच हाइपरलिंक के साथ किया जा सकता है।

टाइप गार्ड/टाइप प्रेडिकेट सेक्शन विशेष रूप से ऐसा महसूस करता है कि यह अपने पेज का हकदार है।

टाइपप्रति पुस्तकालय लिखने के लिए मार्गदर्शन

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

टैग: libraries , guidance

मोबाइल नेविगेशन मुश्किल हो सकता है

मैं मोबाइल से वेबसाइट हैंडबुक नहीं पढ़ सकता जो काफी निराशाजनक है। साथ ही यह बहुत अच्छा होगा यदि आप पुस्तिका के प्रत्येक पृष्ठ पर पृष्ठ के निचले भाग में पिछला/अगला नेविगेशन प्राप्त कर सकें।

एक ट्वीट से

टैग: nav

अधिक वास्तविक दुनिया के उदाहरणों का प्रयोग करें

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

नोट: दस्तावेज़ीकरण के कुछ क्षेत्र पहले से ही इस मुद्दे को संभालते हैं 👌🏻 लेकिन यह हिट एंड मिस है।

टैग: examples

उदाहरण पुस्तकालय और सर्वोत्तम अभ्यास

दिखाएँ कि विभिन्न प्रकार के फ़ंक्शन कैसे टाइप करें। जैसे लॉश में सभी प्रकार के फैंसी फंक्शन होते हैं जैसे पिक, एक्सटेंड, फ़्लैटन आदि उन्हें टाइप करने का तरीका बताएं।

एक पुस्तकालय जो जटिलता में वृद्धि करता है। यह कमिट करने के लिए और लिंक भी पढ़ सकता था जो दिखाता है कि टीएस में एक निश्चित चीज़ का उत्पादन में कैसे उपयोग किया जाता है।

जो कुछ भी बनाया जा रहा है, मुझे आशा है कि किसी के लिए उदाहरण जोड़ना बहुत आसान है। मुझे लगता है कि यह गिट रेपो की तरह एक टीएस हैंडबुक होगी।

सर्वश्रेष्ठ ओपन सोर्स प्रोजेक्ट्स में आमतौर पर सर्वश्रेष्ठ दस्तावेज़ीकरण और नया उपयोगकर्ता अनुभव होता है।

आइए नए उपयोगकर्ताओं के लिए TS को और अधिक स्वागत योग्य बनाएं।

Tsconfig विकल्पों का बेहतर विवरण

कंपाइलर विकल्प पृष्ठ पर वर्तमान विवरण

• प्रत्येक विकल्प का एक बहुत ही अस्पष्ट विवरण प्रदान करता है और यह संकलन और प्रकार की जाँच को कैसे प्रभावित करता है। कुछ उदाहरण वास्तव में उपयोगी हो सकते हैं।
• तालिका प्रारूप विवरण के लिए थोड़ी जगह छोड़ता है
• टाइपस्क्रिप्ट संस्करण के बारे में कोई जानकारी नहीं है
• वर्णानुक्रमिक क्रम उपयोगी नहीं है, कुछ विकल्प एक दूसरे से निकटता से संबंधित हैं जैसे target , module और lib या सभी सख्त जैसे विकल्प। जब आप उन्हें अलग-अलग देखते हैं तो उन्हें अच्छी तरह समझ पाना मुश्किल होता है। तुम नहीं समझोगी lib समझे बिना विकल्प target पहले।
• अधिकांश समय लोग उन विकल्पों का उपयोग tsconfg फ़ाइलों में करते हैं, न कि tsc विकल्पों के रूप में इसलिए वर्तमान प्रारूप नए लोगों के लिए भ्रमित करने वाला हो सकता है।
• कुछ विकल्पों के अधिक विस्तृत विवरण दस्तावेज़ों में बिखरे हुए हैं जैसे @types , typeRoots और types विकल्प tsconfig.json पेज और baseUrl और paths में वर्णित हैं मॉड्यूल संकल्प में

यह विशिष्ट कंपाइलर झंडे सुझाव

संपादित करें:
कंपोजिट प्रोजेक्ट्स के निर्माण से संबंधित नए विकल्पों का उल्लेख नहीं करने के लिए, जिसके लिए डॉक्स में कोई जानकारी नहीं है और आपको रिलीज नोट्स और गिटहब मुद्दों के आधार पर पूरी तस्वीर को एक साथ रखने के लिए मजबूर किया जाता है।

टैग: tsconfig

दस्तावेज़ीकरण, ब्लॉग और अन्य आधिकारिक संसाधनों को एक स्थान पर एकत्रित करें

यदि हम टाइपस्क्रिप्ट के बारे में सभी आधिकारिक संसाधनों को एक स्थान पर एकत्र कर सकते हैं (जैसे www.typescriptlang.org ), तो यह बहुत अच्छा होगा! मैं

उदाहरण के लिए, v3.5 घोषणा के बारे में ब्लॉग पोस्ट किसी अन्य स्थान पर है ( devblogs.microsoft.com ):
https://devblogs.microsoft.com/typescript/announcing-typescript-3-5/

और, v3.4 रिलीज़ नोट दूसरी जगह पर है:
https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-4.html

मुझे लगता है कि टाइपस्क्रिप्ट डेवलपर्स के लिए यह बहुत उपयोगी और भ्रमित करने वाला नहीं है। मैं

टैग: blog , resources

अपनी प्राथमिकताओं और प्रोजेक्ट सेटअप के साथ UI फ़ॉर्म भरकर tsconfig.json बनाएं

यह अच्छा होगा, यदि दस्तावेज़ीकरण में एक प्रपत्र/विज़ार्ड होगा जो tsconfig.json उत्पन्न करने में मदद करता है जो लक्षित वातावरण (ब्राउज़र, नोडजेएस), उपयोगकर्ता वरीयताओं (उपयोगकर्ता के रूप में सख्त या उदार) और परियोजना निर्देशिका संरचना के अनुकूल है। वर्तमान में टीएस कंपाइलर विकल्पों में कई पदावनत विकल्प और कुछ कंपाइलर झंडे होते हैं, जो पहली नजर से ऐसा लगता है कि वे एक ही काम कर सकते हैं (कुछ विकल्पों के बीच अंतर क्या हैं, उदाहरण के लिए पथ/डीआईआर/जड़ से संबंधित)। उत्पन्न tsconfig को Microsoft टाइपस्क्रिप्ट कोर टीम के सर्वोत्तम अभ्यासों का पालन करना चाहिए। अन्य मार्गदर्शक प्रश्न में शामिल हो सकते हैं:

• टाइपस्क्रिप्ट के साथ प्रोजेक्ट डेवलपमेंट टीम का अनुभव क्या है ("टीएस गुरुओं" के लिए सभी सख्त विकल्पों का सुझाव देते हुए नौसिखियों को संबंधित कंपाइलर विकल्प "जेएस टू टीएस माइग्रेशन पथ" सुझा सकता है)
• परियोजना एक पुस्तकालय या अनुप्रयोग है (कुछ निर्भरता वाले पुस्तकालय के मामले में कुछ सख्त सुविधाओं का उपयोग करना आसान हो सकता है, जैसे strictNullChecks , इसलिए उपयोगकर्ता अनुभव के आधार पर इसका सुझाव दिया जा सकता है)
• JSX/TSX (प्रतिक्रिया) का उपयोग करने वाला एप्लिकेशन है
• क्या आप फ्रेमवर्क/लाइब्रेरी का उपयोग कर रहे हैं, जो डेकोरेटर्स का उपयोग करता है?
  
  
  
  • डेकोरेटर मेटाडेटा उत्सर्जित होना चाहिए, इसलिए इसे रनटाइम पर फ्रेमवर्क/लाइब्रेरी द्वारा उपयोग किया जा सकता है (उदाहरण के रूप में ढांचे और पुस्तकालयों, जैसे कोणीय, ऑरेलिया का उल्लेख करें)
  
  

टैग: tsconfig , examples , guides , wizard , exploration

@orta मुझे लगता है कि खेल के मैदान का मोबाइल संस्करण बनाना, या कम से कम वर्तमान को अनुकूलित करना बहुत अच्छा होगा। अभी तक, खेल का मैदान मोबाइल पर भयानक लगता है (स्क्रीनशॉट iPhone 7 पर बनाया गया है)।

काश वेबसाइट के "हैंडबुक" क्षेत्र में एक खंड होता जो विशेष रूप से वस्तु शाब्दिक और विभिन्न तरीकों से बात करता था जिससे आप उन्हें टाइप कर सकते हैं।

उदाहरण के लिए, मैं लगातार Google को "किसी भी गुण के साथ टाइपस्क्रिप्ट ऑब्जेक्ट शाब्दिक" या "एक आवश्यक संपत्ति और किसी भी अन्य गुणों के साथ टाइपस्क्रिप्ट ऑब्जेक्ट शाब्दिक" जैसा कुछ दे रहा हूं।

और मुझे हमेशा { [key: string]: any } प्रकार को देखना होता है, जिस पर वास्तव में कहीं भी चर्चा नहीं की जाती है।

इनमें से कुछ चीजें "इंटरफेस" पर बात की जाती हैं लेकिन यह तुरंत स्पष्ट नहीं होती है।

विक्रेता प्रकार बढ़ाना

कभी-कभी निश्चित रूप से टाइप किए गए प्रकारों या अन्य विक्रेता मॉड्यूल परिभाषाओं के साथ काम करते समय, मुझे लगता है कि मुझे परिभाषाओं को या तो ट्विक करने की आवश्यकता है:

1) मौजूदा परिभाषा को अधिलेखित / संशोधित करें
2) एक नई विधि / गुण जोड़ें

मैं विभिन्न परिदृश्यों में कार्य को पूरा करने के लिए उचित तरीके से दस्तावेज नहीं ढूंढ पा रहा हूं। मैंने भी अच्छे नोट्स नहीं लिए हैं जब मुझे इसे स्वयं करने की आवश्यकता होती है । https://www.typescriptlang.org/docs/handbook/declaration-merging.html प्रथम पक्ष कोड के लिए समस्या का समाधान करता है लेकिन मैंने उस सलाह को तृतीय पक्ष मॉड्यूल प्रकार/निर्यात के लिए काम नहीं किया है।

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

टैग: vendor

कंपाइलर एपीआई दस्तावेज

विकी के पास कंपाइलर एपीआई (https://github.com/microsoft/TypeScript/wiki/Using-the-Compiler-API) का उपयोग करने के बारे में कुछ जानकारी है, लेकिन केवल कुछ लक्ष्यों को पूरा करने के लिए इसका उपयोग करने के उदाहरण दिखाता है। विशिष्ट वस्तुओं और विधियों को सूचीबद्ध करने के लिए और वे क्या करते हैं, इसके बारे में जानने के लिए अधिक JSDoc शैली की जानकारी प्राप्त करना बहुत अच्छा होगा। अभी मैं एपीआई सीखने की कोशिश कर रहा हूं और क्या हो रहा है यह जानने के लिए टाइपस्क्रिप्ट स्रोत को देखने की जरूरत है।

(कृपया अनदेखा करें यदि यह सिर्फ इसलिए नहीं किया गया है क्योंकि एपीआई अभी तक स्थिर नहीं है जैसा कि विकी पर बताया गया है)

टैग: compiler

ट्यूटोरियल जो मौजूदा भाषाओं की तुलना में टीएस पर ध्यान केंद्रित करते हैं

बहुत से लोग टाइपस्क्रिप्ट में अपनी दूसरी (या अधिक) भाषा के रूप में आते हैं। टाइपस्क्रिप्ट सीखने को सरल बनाने का एक तरीका यह है कि इसकी तुलना किसी मौजूदा भाषा से की जाए जिसे आप पहले से जानते हैं। हम लोकप्रियता के आधार पर शीर्ष प्रोग्रामिंग भाषाओं को ले सकते हैं जैसे जेएस, जावा, सी #, पीएचपी, सी (+ सीपीपी) और रूबी - फिर ऐसे ट्यूटोरियल निर्देशित किए हैं जो मानते हैं कि आपको इस बात का ज्ञान है कि वह भाषा कैसे काम करती है।

अभी हम केवल यह अनुमान लगाते हैं कि आप JS को जानते हैं।

टैग: tutorials

सुनिश्चित करें कि यह डिफ़ॉल्ट रूप से सुलभ है

सुनिश्चित करें कि लिंटर्स जैसे accessibilityinsights.io पास

टैग: infra

खेल के मैदान के लिए संक्षिप्त, साझा करने योग्य URL

यह बहुत अच्छा होगा यदि टाइपस्क्रिप्ट खेल का मैदान का "साझा करें" बटन पूरे स्रोत कोड को URL में डंप करने के बजाय छोटे URL उत्पन्न करता है।

वैकल्पिक रूप से, URL को एक github gist ID रखने की अनुमति दें जो खेल के मैदान को पॉप्युलेट करता है। उदाहरण: https://www.typescriptlang.org/play?gist=eb25a1f350e50d6ed3561a777fbfe424

टैग: playground

विभिन्न सेटिंग्स वाले उदाहरण (विभिन्न उपयोग के मामलों/परिदृश्य के लिए)

मुझे यह जानने में मुश्किल हुई कि मैं अपने टीएस कोडबेस को कैसे कॉन्फ़िगर कर सकता हूं और विभिन्न कोडबेस के लिए मैं किन उदाहरणों का अनुसरण कर सकता हूं, इसलिए यह बहुत अच्छा होगा यदि https://github.com/microsoft/TypeScriptSamples/ जैसे उदाहरणों की सूची वेबसाइट पर दिखाई देगी। यह दिखाने के लिए कि कोई व्यक्ति tsconfig.json को कैसे कॉन्फ़िगर करेगा और उसे टीएस फाइलों की संरचना कैसे करनी चाहिए ताकि वह काम कर सके।

टैग: docs , examples

कोई स्पष्ट कारण नहीं है कि डॉक्स विकि बनाम हैंडबुक में क्यों होंगे

विकी में this पर पेज is_awesome_ और काश मैं इसे जल्दी ढूंढ पाता। हमें यह पता लगाना चाहिए कि विकि में किस तरह की चीजें रहनी चाहिए (विशेषकर क्योंकि यह किसी और के द्वारा आसानी से संपादन योग्य नहीं है (बाहरी लोगों को एक पीआर भेजना होगा)) और अन्य चीजों को साइट पर ले जाना चाहिए।

विषयों और शीर्षकों के बीच बेहतर नेविगेशन बनाएं

हैंडबुक उन्नत प्रकार जैसे विशाल विषयों में अलग-अलग शीर्षकों के बीच खराब नेविगेशन है, कोई ऊपर जाने वाला बटन भी नहीं है। फ्लोटिंग नेविगेशन मेनू जोड़ना वाकई अच्छा होगा। वर्तमान में एक शीर्षक से दूसरे शीर्षक पर कूदना या किसी वांछित का शीघ्रता से पता लगाना कठिन है।

इस असेंबली स्क्रिप्ट गिट बुक में दिए गए नेविगेशन का एक अच्छा उदाहरण यहां दिया गया है: https://docs.assemblyscript.org/basics/environment

टैग: website , handbook , navigation

मोबाइल के अनुकूल खेल का मैदान कोड संपादन

जैसा कि मैं इसे समझता हूं, सिंटैक्स हाइलाइटिंग और अन्य सभी आईडीई सुविधाओं के साथ मोबाइल के अनुकूल कोड संपादन एक दर्द है।

हालांकि, मैंने पाया है कि मैं अपने फोन पर, डेस्कटॉप/लैपटॉप से ​​दूर, अक्सर कोड स्निपेट के साथ खेलना चाहता हूं।

मोबाइल उपयोग के लिए सिंटैक्स हाइलाइट किए गए संपादक के बजाय, मुझे एक सादा <textarea> फ़ील्ड से कोई आपत्ति नहीं होगी।

त्रुटियां संभवतः किसी अन्य पृष्ठ या पॉपअप या किसी अन्य HTML तत्व पर हो सकती हैं।

टैग: खेल का मैदान, मोबाइल, कोड संपादक

ब्राउज़र संगत es6 मॉड्यूल के लिए .js एक्सटेंशन जोड़ने वाला दस्तावेज़

कहीं भी कोई उल्लेख नहीं है कि टाइपस्क्रिप्ट का उपयोग es6 मॉड्यूल उत्पन्न करने के लिए पूरी तरह से अच्छी तरह से किया जा सकता है जो ब्राउज़र में काम करते हैं बस आयात के नाम पर .js एक्सटेंशन जोड़कर! यह जानकारी मौजूद होने का एकमात्र स्थान इस धागे में है:
https://github.com/Microsoft/TypeScript/issues/16577#issuecomment -343610106

सुनिश्चित नहीं है कि TS के किस संस्करण ने इसे जोड़ा है, लेकिन './file.js' जैसे आयात अब काम करते हैं (भले ही फ़ाइल वास्तव में file.ts हो)।

मेरे लिए यह एक बड़ी विशेषता थी... लेकिन आधिकारिक तौर पर यह मौजूद नहीं है?!

उन्नत प्रकार पृष्ठ में Omit<T, K> प्रकार शामिल नहीं है।

Omit<T, K> हाल ही में टाइपस्क्रिप्ट 3.5 में जोड़ा गया था, लेकिन उन्नत प्रकार पृष्ठ में अभी भी निम्न अस्वीकरण है:

नोट: बहिष्कृत प्रकार यहां सुझाए गए डिफ प्रकार का उचित कार्यान्वयन है। हमने डिफ को परिभाषित करने वाले मौजूदा कोड को तोड़ने से बचने के लिए बहिष्कृत नाम का उपयोग किया है, साथ ही हमें लगता है कि नाम बेहतर प्रकार के शब्दार्थ को बताता है। हमने Omit . को शामिल नहीं कियाटाइप करें क्योंकि इसे तुच्छ रूप से पिक . के रूप में लिखा गया है>.

लिंटर्स के लिए प्रोजेक्ट सेटअप दस्तावेज़ प्रदान करें

एक परियोजना की स्थापना के भाग के रूप में, लिंटर के साथ सेटअप करने का तरीका शामिल करें, सबसे अधिक संभावना केवल टाइपस्क्रिप्ट-एस्लिंट है जिसे परियोजना को स्वयं उपयोग करना चाहिए।

टैग: linter

सबसे अधिक प्रभावित होने वाली त्रुटियों या टाइपस्क्रिप्ट सीमाओं को कवर करने वाला कुछ भी नहीं है।

जब आप पहली बार टाइपस्क्रिप्ट सीख रहे हैं, तो कुछ ऐसे पैटर्न हैं जो + नहीं हैं और टाइपस्क्रिप्ट में कभी भी समर्थित नहीं होंगे। सबसे सरल में से एक:

const buildResult = (name?: string) => {
  const result = {};
  if (name) {
    result.name = name; // error, this property doesn't exist on {}
  }
  return result;
};

मैंने अपनी कंपनी के लिए टाइपस्क्रिप्ट शुरू करना शुरू कर दिया है, और इस तरह के मामले बहुत अधिक आते हैं, इसलिए मैंने उन्हें अक्सर पूछे जाने वाले प्रश्न/गाइड की समस्या निवारण शैली में दस्तावेज करना शुरू कर दिया है। यह तेजी से बढ़ रहा है (ध्यान दें कि यह खराब स्थिति में है):

एक समय में एक वस्तु एक संपत्ति का निर्माण
जब आप चाहते हैं तो आपको त्रुटियां क्यों नहीं मिल रही हैं: अतिरिक्त संपत्ति जांच
यूनियनों सहित वैकल्पिक गुणों का उपयोग कैसे करें
क्यों Object.keys और Object.entries वह नहीं करते जो आप चाहते हैं
फ़िल्टर फ़िल्टर बनाना, त्रुटियों के बिना काम कम करना
प्रकार शोधन खो रहा है

यदि इनमें से कोई भी जानकारी डॉक्स में है, तो मैं इसे ढूंढ नहीं पाया। मैंने इन्हें केवल वर्षों के परीक्षण/त्रुटि के माध्यम से, और जीथब पर सबसे अधिक जुड़े मुद्दों के माध्यम से पढ़ा है।

टैग: errors , troubleshooting , limitations

कस्टम प्रकार की परिभाषाओं को जोड़ने के तरीके के बारे में स्पष्ट दस्तावेज़ प्रदान करें

ऐसे कई पुस्तकालय हैं जिनमें प्रकार शामिल नहीं हैं, और जिनके पास @types/* पैकेज उपलब्ध नहीं है। मैं अपने प्रोजेक्ट के अंदर इनके लिए अपनी घोषणा फाइलें लिखने में सक्षम होना चाहता हूं, लेकिन उन्हें लिखने और उन्हें पहचानने के लिए टाइपस्क्रिप्ट प्राप्त करने के 'दाएं' तरीके पर कोई दस्तावेज प्रतीत नहीं होता है। मान लें कि मैं npm से एक मॉड्यूल आयात कर रहा हूँ। क्या मुझे declare module x का उपयोग करने की आवश्यकता है? या declare module "x" ? या नामस्थान का उपयोग करें? या सिर्फ प्रकार निर्यात करें? क्या इन फ़ाइलों को रखने के लिए मुझे कोई विशिष्ट स्थान चाहिए? मुझे कौन से कॉन्फ़िगरेशन विकल्प सेट करने की आवश्यकता है? typeRoots ? types ? paths ? include ? और क्या? - मैंने अब तक जो कुछ भी पाया है वह भ्रमित करने वाले त्रुटि संदेश, खराब तरीके से समझाए गए कॉन्फ़िगरेशन विकल्प और पुराने SO प्रश्न हैं।

टैग: docs

ऑफ़लाइन दस्तावेज़ीकरण का अभाव

आधुनिक बुनियादी उपकरण जैसे git या npm में कमांड का अपना सबसेट होता है जो हमें ऑफ़लाइन दस्तावेज़ीकरण/संदर्भ तक पहुंचने की अनुमति देता है जैसे:

$ git help ls-remote
$ npm help search 

मुझे लगता है कि ऐसी सुविधा होना अच्छा होगा (भले ही टीएस थोड़ा अलग हो)।
यह हमें help जैसे कमांड के माध्यम से साइट/जीथब आदि को संदर्भित किए बिना स्थानीय रूप से डॉक्स का पता लगाने की अनुमति देगा:

$ tsc help tsc # basic CLI arguments desc
$ tsc help config # opens up html page of the tsconfig.json docs
$ tsc help v3.5 # opens up html page changelog
$ tsc help enum # finds pages containing `enum` type and hints their names/opens them up

टैग: offline , search , cli , local

उदाहरणों को कुछ बेहतर विशिष्ट रंगों की आवश्यकता है!

यह कैसा होना चाहिए:

const whomstve = (name: string) => name + 'is life'

यह वर्तमान में कैसा है:

const whomstve = (name: string) => name + 'is life'

थोड़ा नीला है, लेकिन बस इतना ही।

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

आइए प्रतिक्रियाओं के आधार पर इन सभी बिंदुओं को पठनीयता के लिए थोड़ा फेरबदल के साथ देखने का प्रयास करें।

एपीआई दस्तावेज़ कभी-कभी केवल रिलीज़ नोट में मौजूद हो सकते हैं

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

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

वेबसाइट पर कोई खोज नहीं

हाँ, मैं सहमत हूँ, यह निश्चित रूप से नई साइट के लिए महत्वपूर्ण है।

वेबसाइट बंद स्रोत है

फिक्स्ड! https://github.com/microsoft/TypeScript-website

नया काम मास्टर शाखा से हट जाएगा, लेकिन अभी के लिए पुरानी साइट ऊपर और पीआर लेने के लिए उपलब्ध है। मैं टाइपस्क्रिप्ट रेपो से मुद्दों को यहां भी ले जा रहा हूं, इसलिए उन सभी पर नज़र रखना आसान है।

यूटिलिटी पेज अप-टू-डेट नहीं हैं

फिक्स्ड! भाग में मैंने बहुत सारे पीआर को मिला दिया, और समुदाय से वर्तमान हैंडबुक को अपडेट किया। साथ ही यह सुनिश्चित करने के साथ कि यह नौसेना में दिखाई देगा (बजाय केवल वेब-खोज से)

बेहतर TS कॉन्फ़िग विकल्प विवरण

मैंने सप्ताहांत में इसकी खोज शुरू की (हम यह कैसे सुनिश्चित कर सकते हैं कि संकलक और वेबसाइट इन दस्तावेज़ों के लिए एक ही प्रारंभिक डेटा स्रोत साझा करते हैं, और वेबसाइट अधिक संदर्भ प्रदान करने के लिए इसके ऊपर क्या निर्माण कर सकती है)

दिशा के अब तक के कुछ उदाहरण:

• 2017 से मेरे अपने नोट्स
• मैं एथन एरोवुड @matterhorndev के साथ चैट कर रहा tsconfig-ui TSConfig एक्सप्लोरर बनाने की नींव हो सकता है

खेल का मैदान विकल्प जितना अच्छा नहीं है

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

( अंजीर अन्वेषण के लिए क्लिक करें )

खेल के मैदान के लिए लघु साझा करने योग्य URL

फिक्स्ड, नीचे देखें

प्रकार के नामों की कोई शब्दावली नहीं

मैंने अपना खुद का लिखना शुरू कर दिया है, जैसा कि मैं संकलक सीखता हूं - मैं इस फ़ीड को नई हैंडबुक में देखने की उम्मीद करता हूं। यह खेल के मैदान के उदाहरणों को भी प्रभावित करता है, जो कुछ अधिक उन्नत प्रकारों के उदाहरणों की शब्दावली के रूप में कार्य करता है

[खेल का मैदान पूर्व १, खेल का मैदान पूर्व २]

उत्तरोत्तर TS . नहीं सिखाता है

इसका उद्देश्य नई पुस्तिका में कुछ #29288 उद्धृत करना है (स्क्रॉल करके New handbook )

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

1. अनुरूप परिचय (कोर हैंडबुक के लिए सेटअप)
   
   
   
   1. कोर हैंडबुक (हर कोई इसे पढ़ता है)
   
   
   2. संदर्भ पृष्ठ (डीप-डाइव्स/परिशिष्ट की तरह)
   
   

प्रभावी रूप से इसके कुछ अलग शुरुआती बिंदु हैं और फिर जब आप आसपास के पारिस्थितिकी तंत्र से परिचित हो जाते हैं तो भाषा सिखाने की कोशिश करते हैं।

क्या वह टिप्पणी में सब कुछ संबोधित करता है? नहीं, बस शुरुआत। मेरे पास वर्तमान साइटमैप काफी व्यापक है, और इस प्रकार की समस्याओं में मेरी दिलचस्पी है

मैंने अपनी वर्तमान साइट-मैप कुकबुक और गाइड में कुछ विग्गल रूम छोड़ा है, कुकबुक कुछ ऐसा है जिससे हम अधिक सामुदायिक समर्थन को प्रोत्साहित कर सकते हैं।

गाइड प्रदान करें

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

ऊपर की तरह, मुझे लगता है कि साइट के कुकबुक और वास्तविक गाइड अनुभाग इसे कवर करने के लिए पर्याप्त होना चाहिए

भाषा विशिष्टता पुरानी है

हाँ, मुझे नहीं पता कि क्या मैं इसे मुख्य रेपो से एकमुश्त हटा सकता हूँ - लेकिन नई साइट पर इसका उल्लेख नहीं किया जाएगा।

कोड नमूने के लिए बेहतर आईडीई-जैसे अनुभव प्रदान करें

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

संकलक त्रुटि सूचकांक पृष्ठ

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

वास्तविक दुनिया के और उदाहरण दिखाएं

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

साइट में मोबाइल सपोर्ट कमजोर है

मैं नई साइट के लिए माइक्रोसॉफ्ट डिजाइन सिस्टम (द्रव) का उपयोग करने पर विचार कर रहा हूं, जिसका अर्थ यह होना चाहिए कि मोबाइल समर्थन (पहुंच के साथ) "ज्यादातर मुफ्त में" आना चाहिए।

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

tsc सहायता सुधार एक्सप्लोर करें

मैं इसके लिए खुला हूं, लेकिन टाइपस्क्रिप्ट सीएलआई वास्तव में केवल एक कमांड है, संकलित करें (यही कारण है कि उप-आदेशों पर मदद की कोई आवश्यकता नहीं है (हालांकि --init थोड़े टूट जाता है))

डीटीएस में सुधार के बारे में सलाह दें

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

दस्तावेज़ों/ब्लॉगों/रिलीज़ नोटों को समेकित करें

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

आसान पक्ष पर, मैं निश्चित रूप से इस प्रकार की जानकारी को विकी से हटाना चाहता हूं और इसे केवल वेबसाइट के अंदर छोड़ना चाहता हूं (जहां इसे साइट खोज द्वारा अनुक्रमित किया जा सकता है) - मैं विशेष रूप से योगदान देने के लिए टाइपस्क्रिप्ट विकी छोड़ना चाहता हूं टाइपस्क्रिप्ट और टाइपस्क्रिप्ट कंपाइलर एपीआई के साथ काम करना (उदाहरण के लिए जब आप import * as ts from “typescript” , या एक भाषा सर्वर प्लगइन बनाते हैं)

सबसे अधिक हिट होने वाली त्रुटियों को कवर करें

यह उपरोक्त से संबंधित है - इस प्रकार की समस्याओं के लिए वास्तव में व्यापक एफएक्यू पृष्ठ है, जिसे मैंने अभी विकी में खोजा है (टीएस के मेरे उपयोग में 3 वर्ष)।

हम इसे आधार रेखा के रूप में ले सकते हैं और आपकी प्रतिक्रियाओं के साथ उन्हें मुख्य वेबसाइट में भी खींचना शुरू कर सकते हैं

सिंटैक्स हाइलाइटिंग जोड़ें

हाँ सहमत हूँ, धन्यवाद!

कुल मिलाकर, मुझे लगता है कि हमने इनमें से बहुत कुछ को सक्रिय रूप से खोजा या काम किया है, और मैं अधिक प्रतिक्रिया के लिए तैयार हूं क्योंकि हम दस्तावेज़ों पर काम करना जारी रखते हैं!

बहुत बढ़िया काम @orta बहुत बहुत धन्यवाद!

एक अलग बनाने के बजाय, खेल के मैदान संपादक में VSCode tsconfig अनुभव के साथ उधार लेने/सुधारने/सहयोग करने के बारे में कैसे?

खेल के मैदान को बेहतर बनाता है, और VSCode में मौजूदा अनुभव पहले से ही आधा-सभ्य है।

मुझे सच में यकीन नहीं है कि आपका क्या मतलब है। वीएस कोड में स्वत: पूर्ण JSON स्कीमा सुविधाओं की तरह? मैं इसे JSON संपादक भाग में रखने की योजना बना रहा था, लेकिन लेबल के साथ GUI के रूप में हर विकल्प का अवलोकन सभी विकल्पों को देखने और चुनने और चुनने का एक उपयोगी तरीका है।

@orta जब नई हैंडबुक आधिकारिक हैंडबुक बन जाती है, तो क्या यूआरएल मौजूदा हैंडबुक ब्रेक के अनुभागों की ओर इशारा करेंगे? या नई पुस्तिका किसी भिन्न URL पर होगी? मैं बस सोच रहा हूं क्योंकि मैंने पिछले कई सालों में SO उत्तरों में हैंडबुक लिंक के स्कैड रखे हैं (मुझे यकीन है कि दूसरों ने भी ऐसा किया है) और अगर वे सभी टूट गए तो यह दुर्भाग्यपूर्ण होगा। (क्या सामान्य दस्तावेज प्रवासन योजनाओं के बारे में बात करने के लिए कोई बेहतर मुद्दा या स्थान है?)

@orta @jcalz एक ही बात सोच रहा था, मेरे पास 2.5K से अधिक SO उत्तर हैं, लिंक के साथ सभी उत्तर ढूंढना और उन सभी को अपडेट करना संभव नहीं है। आदर्श रूप से टुकड़ों के साथ लिंक अभी भी काम करेंगे और नए स्थानों पर रीडायरेक्ट करेंगे। जरूरत पड़ने पर मैं मैपिंग में मदद करने को तैयार हूं।

हां, मैं यूआरआई को

मुझे लगता है कि यह संभवतः हैंडबुक के लिए एक नए यूआरएल रूट का उपयोग करने जा रहा है (उदाहरण के लिए docs/handbook/x.html बल्कि शायद /handbook/x.html ), और पुराने पृष्ठों को मानचित्र के माध्यम से अपने निकटतम समकक्ष पर फिर से निर्देशित कर रहा है किसी प्रकार का।

मैं जानना चाहता हूं कि इस भंडार के लिए सभी जीथब लेबल का क्या अर्थ है। उनमें से कुछ स्व-व्याख्यात्मक हैं, लेकिन अन्य नहीं हैं।

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

_specific_ कंपाइलर विकल्पों के लिए डॉक्स से लिंक नहीं किया जा सकता

मेरी टीम टाइपस्क्रिप्ट के लिए अपेक्षाकृत नई है, और इस तरह, हमारी tsconfig.json बार-बार बदल रही है, और कई बार मैं लोगों को विशिष्ट कंपाइलर विकल्पों के लिए दस्तावेज़ीकरण की ओर इंगित करना चाहता हूं, अर्थात:

https://www.typescriptlang.org/docs/handbook/compiler-options.html#strict-null-checks
(or)
https://www.typescriptlang.org/docs/handbook/compiler-options.html#strictNullChecks

इस तरह के लिंक काम नहीं करते हैं, लेकिन मैं उन्हें चाहता हूं।

वर्तमान में मैं उस पृष्ठ पर देख सकता हूं कि एकमात्र HTML आईडी # कंपाइलर-विकल्प है, जो कि उपयोगी नहीं है क्योंकि यह मूल रूप से शीर्ष पर है - प्रत्येक विकल्प के लिए एक आईडी होना, हालांकि, लोगों को प्राप्त करने के लिए बहुत उपयोगी होगा पृष्ठ का वांछित भाग।

टैग: compiler

@ टायलर-मर्फी हमने अभी तय कर लिया है

@ssalka - हाँ, अच्छी कॉल जो नए tsconfig डॉक्स में होगी

--

मैं इस मुद्दे को बंद करने जा रहा हूं, एक बार जब हम हैंडबुक और नई साइट में आगे आ जाएंगे तो मैं उसी आधार के साथ भविष्य में एक नया खोलूंगा

टाइपप्रति खेल का मैदान:
मुझे लगता है कि मैं पागल हो रहा हूं, लेकिन मुझे अपनी परियोजना को सहेजने और साझा करने के लिए एक सरल 'साझा' विकल्प नहीं मिल रहा है (उदाहरण के लिए एक जीथब मुद्दे में जोड़ने के लिए)।
मैं 'निर्यात' के तहत सभी लिंक देखता हूं लेकिन 'शेयर' नहीं करता।

टाइपप्रति खेल का मैदान:
मुझे लगता है कि मैं पागल हो रहा हूं, लेकिन मुझे अपनी परियोजना को सहेजने और साझा करने के लिए एक सरल 'साझा' विकल्प नहीं मिल रहा है (उदाहरण के लिए एक जीथब मुद्दे में जोड़ने के लिए)।
मैं 'निर्यात' के तहत सभी लिंक देखता हूं लेकिन 'शेयर' नहीं करता।

उदाहरण: खेल का मैदान लिंक

नई साइट वास्तव में अच्छी लग रही है! हालांकि मैंने देखा कि यह अनुरोध (कंपाइलर विकल्पों के लिए एंकर लिंक) ने इसे . में नहीं बनाया

ऐसा लगता है कि इसे समायोजित करना वास्तव में आसान अनुरोध होगा और नए लोगों के लिए बहुत मददगार होगा। भविष्य के अपडेट में इसे देखने की उम्मीद है!