Shapely: स्वचालित दस्तावेज़ बनाता है

संयोग से, matplotlib पहले से ही ऐसा करता है। देखें https://github.com/matplotlib/matplotlib/blob/master/.travis.yml#L126

मुझे निश्चित रूप से लगता है कि प्रक्रिया में सुधार किया जा सकता है हालांकि ...

इसके अतिरिक्त, मुझे अभी पता चला है कि ReadTheDocs अब कोंडा इंस्टॉलेशन कर सकता है, जिससे आरटीडी शेपली डॉक बिल्डिंग के लिए एक व्यवहार्य विकल्प बन गया है (मैंने कुछ सफलता के साथ कार्टोपी के लिए अवधारणा का प्रमाण किया)।

इस ट्यूटोरियल के आधार पर मैंने इसे देखा है और कुछ काम कर रहा है: https://gist.github.com/domenic/ec8b0fc8ab45f39403dd

परिवर्तन यहाँ हैं: https://github.com/Toblerity/Shapely/compare/master...snorfalorpagus :autodoc

इस प्रक्रिया के लिए आपको एक नई SSH कुंजी जोड़ी बनाने और निजी कुंजी के एन्क्रिप्टेड संस्करण को रेपो/ट्रैविस में डालने की आवश्यकता है।

यह केवल एक उदाहरण में प्रलेखन बनाने के लिए स्थापित किया गया है (पायथन 3.5 स्पीडअप के साथ)। https://travis-ci.org/snorfalorpagus/Shapely/jobs/177188968

इसने इस बात पर प्रकाश डाला है कि प्रलेखन में आंकड़े बनाने वाली कुछ स्क्रिप्ट पायथन 3.x के साथ संगत नहीं हैं, उदाहरण के लिए buffer.py जो देता है:

Traceback (most recent call last):
  File "buffer.py", line 29, in <module>
    ax.set_xticks(range(*xrange) + [xrange[-1]])
TypeError: unsupported operand type(s) for +: 'range' and 'list'

@snorfalorpagus इससे पहले कि आप इस पर अधिक समय व्यतीत करें, मुझे यह देखने दें कि क्या हमारे कई linux1 पहिए रीडथेडॉक्स को एक बेहतर विकल्प बनाने में मदद करते हैं।

यदि आप ट्रैविस रूट पर डॉक्स नीचे जाते हैं तो https://github.com/drdoctr/doctr के बारे में जागरूकता बढ़ाना चाहते हैं।

मैं इसे अगले मील के पत्थर पर ले जा रहा हूं। मैं 1.6.0 को अनब्लॉक करना चाहता हूं और इसके बाद डॉक्टर इंफ्रा पर काम करना चाहता हूं।