Readme.txt बनाम README.txt


33

मैंने सिर्फ जीथब में एक प्रोजेक्ट को कांट-छांट किया है, मेरे बदलाव आदि किए हैं। इससे मुझे आश्चर्य हो रहा है: मैं ज्यादातर ओपन सोर्स प्रोजेक्ट्स में README.txt देखता हूं और मैंने जो फ़ाइल संपादित की वह Readme.txt थी। क्या यह किसी प्रकार का फालिसिस है या क्या मुझे इसे छोड़ देना चाहिए?


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

जवाबों:


29

ऑल-अपरकेस अक्षर बाहर खड़े होते हैं और फ़ाइल को आसानी से दिखाई देते हैं जो समझ में आता है क्योंकि यह शायद पहली चीज है जिसे एक नया उपयोगकर्ता देखना चाहेगा। (या, कम से कम, देखा जाना चाहिए ...) जैसा कि दूसरों ने पहले ही कहा है, कैपिटल लेटर से शुरू होने वाले फ़ाइल नामों को ASCIIbetical सॉर्टिंग ( LC_COLLATE=C) में कम-केस नामों से पहले सूचीबद्ध किया जाएगा जो फ़ाइल को पहली नज़र में दिखाई देने में मदद करता है।

READMEफ़ाइल फ़ाइलें एक नि: शुल्क सॉफ्टवेयर पैकेज का एक उपयोगकर्ता सामान्य रूप से खोजने के लिए उम्मीद करेंगे के एक झुंड का हिस्सा है। अन्य हैं INSTALL(सॉफ़्टवेयर के निर्माण और स्थापना के लिए निर्देश), AUTHORS(योगदानकर्ताओं की सूची), COPYING(लाइसेंस पाठ), HACKING(योगदान करने के लिए कैसे शुरू करें, शायद शुरुआती बिंदुओं की एक TODO सूची सहित), NEWS(हाल ही में परिवर्तन) या ChangeLog(ज्यादातर के साथ बेमानी ) संस्करण नियंत्रण प्रणाली)।

यह जीएनयू कोडिंग मानकों का READMEफाइल के बारे में कहना है ।

वितरण READMEमें पैकेज के सामान्य अवलोकन के साथ एक फाइल होनी चाहिए :

  • पैकेज का नाम;
  • पैकेज की संस्करण संख्या, या पैकेज में जहां संस्करण पाया जा सकता है को देखें;
  • पैकेज क्या करता है का एक सामान्य विवरण;
  • फ़ाइल का संदर्भ INSTALL, जिसमें बदले में स्थापना प्रक्रिया का स्पष्टीकरण होना चाहिए;
  • स्रोत के आसपास अपना रास्ता खोजने के लिए पाठकों के लिए किसी भी असामान्य शीर्ष-स्तरीय निर्देशिकाओं या फ़ाइलों, या अन्य संकेतों का संक्षिप्त विवरण;
  • फ़ाइल में एक संदर्भ जिसमें प्रतिलिपि स्थितियाँ शामिल हैं। जीएनयू जीपीएल, यदि उपयोग किया जाता है, जिसे एक फ़ाइल में बुलाया जाना चाहिए COPYING। यदि जीएनयू एलजीपीएल का उपयोग किया जाता है, तो इसे एक फाइल में बुलाया जाना चाहिए COPYING.LESSER

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


20

परंपरागत रूप से फ़ाइल को अपरकेस में README कहा जाता था क्योंकि कमांड-लाइन वातावरण जो वर्णमाला क्रम का उपयोग करते हैं, फिर फ़ाइल को सबसे ऊपर रख देंगे। यह उन्हें बड़ी निर्देशिकाओं में आसानी से दिखाई देता है।

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

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


मैंने हमेशा सोचा है कि ऑल-अपरकेस जोर का एक रूप था, बहुत कुछ इस तरह से कि आप कानूनी में अपरकेस के खंड कैसे हैं।
लार्स विकलुंड

1
एक कमांड लाइन इंटरफेस पर, जो फाइलें लिस्टिंग के शीर्ष पर जाती हैं, वे वास्तव में वही होती हैं जो पहले स्क्रॉल करती हैं, इसलिए कभी-कभी ये सबसे कम दिखाई देने वाली फाइलें होती हैं। जब तक आप हमेशा कुछ ऐसा नहीं करते हैं ls -l | less
मार्क वैन लीउवेन

6

README आमतौर पर ऊपरी मामले में लिखा जाता है। इस तरह से lsयूनिक्स कमांड ने फाइल को डायरेक्टरी लिस्टिंग की शुरुआत के पास रखा (ऊपरी केस के अक्षर ASCII ऑर्डरिंग में लोअर केस लेटर्स से पहले आते हैं)।


3
यह ऐतिहासिक कारण था, लेकिन lsआमतौर पर आधुनिक प्रणालियों पर इस तरह से छंटनी नहीं होती है।

1
@ dan1111 सही है! धन्यवाद (बस कोशिश करने के लिए ... LC_COLLATE="en_US.ascii" ; ls -lबनाम LC_COLLATE="en_US.UTF-8" ; ls -l)
manlio
हमारी साइट का प्रयोग करके, आप स्वीकार करते हैं कि आपने हमारी Cookie Policy और निजता नीति को पढ़ और समझा लिया है।
Licensed under cc by-sa 3.0 with attribution required.