Skip to content

Contributing hi

Hammad Maqbool edited this page Oct 29, 2026 · 1 revision

English · 简体中文 · 繁體中文 · Español · العربية · Français · Português (Brasil) · Deutsch · हिन्दी · 日本語 · 한국어 · Русский · Bahasa Indonesia · Türkçe · Italiano · Tiếng Việt

docxi में योगदान

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

बग की रिपोर्ट करना

github.com/hammad417/docxi/issues पर issue खोलें, जिसमें ये हों:

  • समस्या दोहराने वाली एक छोटी Ruby स्क्रिप्ट
  • Ruby, docxi, nokogiri और rubyzip के वर्शन (और Rails का, अगर आप इस्तेमाल करते हैं)
  • आपको क्या उम्मीद थी, और क्या मिला। खराब डॉक्यूमेंट के लिए बताएं कि आपने उन्हें किस प्रोग्राम में खोला

सुरक्षा समस्याओं की रिपोर्ट निजी तौर पर करें। सुरक्षा देखें।

पुल रिक्वेस्ट

  1. रिपॉज़िटरी को फ़ोर्क करें और एक ब्रांच बनाएं।
  2. बदलाव करें, और आसपास के कोड की स्टाइल से मेल रखें।
  3. टेस्ट जोड़ें या अपडेट करें, और bundle exec rake test चलाएं।
  4. अगर बना हुआ XML जानबूझकर बदलता है, तो bundle exec rake golden चलाएं और पुल रिक्वेस्ट में बदलाव समझाएं। गोल्डन फ़ाइलें उस आउटपुट की रक्षा करती हैं जिस पर मौजूदा यूज़र निर्भर हैं।
  5. अगर व्यवहार बदलता है, तो CHANGELOG.md और डॉक्यूमेंटेशन अपडेट करें।
  6. पुल रिक्वेस्ट खोलें। CI, Ruby 2.5 से 4.0 और Rails 5.2 से 8.1 पर टेस्ट चलाता है, और जांचता है कि LibreOffice सैंपल डॉक्यूमेंट खोल पाता है।

मौजूदा डॉक्यूमेंट बदलने वाले बदलाव, जैसे 0.2.0 के लिए तय सुधार, अपनी अलग पुल रिक्वेस्ट में होने चाहिए, ताकि गोल्डन फ़ाइलों के अंतर की समीक्षा आसान रहे।

डॉक्यूमेंटेशन और अनुवाद

  • अंग्रेज़ी README, docs/i18n/ में मौजूद 15 अनुवादों का स्रोत है। इसे बदलते समय रिपॉज़िटरी की docs/i18n/TRANSLATION_GUIDE.md का पालन करें।
  • यह विकी रिपॉज़िटरी के wiki/ फ़ोल्डर में लिखी जाती है और वहीं से प्रकाशित होती है। wiki/README.md इसका तरीका बताती है।

संबंधित पेज


← विकी होम · README

Clone this wiki locally