2010-12-02 5 views
7

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

इनमें से एक प्रारूप केवल सबूत-अवधारणा या पायलट प्रयास का समर्थन करने के लिए बनाया गया था। पायलट खत्म हो गया है, इसका अब उपयोग नहीं किया जा रहा है, और यह कुछ अजीब बाधाओं को लगाया गया है। मुझे इसके लिए समर्थन हटाने की अनुमति मिली है। ऐसा करने का सही तरीका क्या है?

मैं सोच रहा हूँ:

  1. खुला एक मुद्दा ट्रैक करने के लिए/दस्तावेज़ परिवर्तन
  2. टैग SVN संशोधन, "FEATURE_X यहाँ निकाला गया"
  3. @Deprecate विशिष्ट वर्गों। इस मुद्दे को उद्धृत करें। प्रतिबद्ध होते हैं।
  4. चेतावनी देखो और देखने के प्रतिवाद क्या प्रभावित करता
  5. यह थोड़ा के लिए बैठते हैं, टीम प्रतिवाद
  6. से निपटने के लिए अंत में कोड को निकालने के लिए एक मौका देता हूँ। सत्यापित करें कि परीक्षण ठीक हैं। प्रतिबद्ध होते हैं।
+3

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

+2

+ संस्करण संख्या को टक्कर दें :) –

+0

+1 उपयोगी सूची - लगभग एक रिफैक्टरिंग रेसिपी – orangepips

उत्तर

3

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

+0

अच्छी कॉल। कुल पुस्तकालय का उपयोग आंतरिक रूप से एक दर्जन लोगों द्वारा किया जाता है, कुछ बाहरी ग्राहक, लेकिन केवल 3 या 4 लोग जानते हैं कि यह विशेष सुविधा भी मौजूद है। – Freiheit

+0

@ फ़्रेहीट मैं कहूंगा: आप कभी नहीं जानते। कुछ मामलों में मैं वास्तव में आश्चर्यचकित था कि कैसे और किसने कोड के दिए गए टुकड़े का उपयोग किया। –

+0

स्वीकृत। कुछ 'मीटस्पेस' पहलुओं को शामिल करता है जो अक्सर कोड पहलुओं से संबोधित करना कठिन होता है। सूखे रन विचार की तरह – Freiheit

5

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

संबंधित मुद्दे