এটি কেবলমাত্র আপনার ব্যবহারকারীদের কী ধরণের স্থায়িত্বের গ্যারান্টি দেয় এবং আপনার ব্যবহারকারীদের জন্য আপনি কতটা বেদনা দিতে চান তার উপর নির্ভর করে depends
আদর্শভাবে, আপনার এপিআই সেমভার ব্যবহার করে যাতে কোনও ব্রেকিং পরিবর্তনের ফলে মূল সংস্করণ নম্বরটি বাড়ানো যায়। অনুশীলনে, এটি প্রায় কখনওই করা বাঞ্ছনীয়। যদি আপনার এপিআই কিছু প্যাকেজ ম্যানেজারের মাধ্যমে ইনস্টল করা থাকে তবে আপনি ব্রেকিং পরিবর্তনের পরে একটি নতুন প্যাকেজ নাম তৈরি করতে চাইতে পারেন যাতে একটি সাধারণ আপগ্রেড দ্বন্দ্ব সৃষ্টি না করে (যেমন myapi2 v2.123.4
বনাম myapi3 v3.2.1
)। এটি অপ্রয়োজনীয় হতে পারে যদি আপনার প্যাকেজ পরিচালক কঠোর সংস্করণ নির্ভরতা সমর্থন করে (যেমন একটি নির্ভরতার নির্দিষ্টকরণ যেমন ~v2.120
অন্তর্ভুক্ত নয় v3.*
) তবে বিভিন্ন প্যাকেজের নামগুলির সুবিধা রয়েছে যে বেমানান সংস্করণগুলি পাশাপাশি খুব সহজে ব্যবহার করা যেতে পারে। এমনকি সেমোভার ব্যবহার করার সময়, অবচয় সময়কাল হওয়াই বুদ্ধিমান হতে পারে।
সেমভার সর্বদা প্রযোজ্য নয়। তারপরে স্পষ্ট স্থিতিশীলতা নীতি যোগাযোগ করা আরও গুরুত্বপূর্ণ। উদাহরণ স্বরূপ:
- পরীক্ষামূলক বৈশিষ্ট্যগুলি বিজ্ঞপ্তি ছাড়াই সরানো হতে পারে।
- সুরক্ষা কারণে যে কোনও সময় বৈশিষ্ট্যগুলি মুছে ফেলা হতে পারে।
- অন্যান্য বৈশিষ্ট্যগুলি কেবল অপসারণ করা হবে
- … প্রকাশিত সংস্করণে অবমূল্যায়ন করার পরে
- … যেখানে সেই সংস্করণটি কমপক্ষে তিন মাস পুরানো
- … এবং প্রধান সংস্করণে একটি দ্বিধা দ্বারা চিহ্নিত করা হবে।
আপনার নিয়মিত প্রকাশ হলে এই জাতীয় নীতিগুলি বিশেষত ভাল কাজ করে যাতে একটি স্পষ্ট অবচয় সময়কাল হয়, যেমন এক বছর।
এপিআইয়ের কোনও অংশকে অবচয় হিসাবে চিহ্নিত করা বাদ দিয়ে আপনার অবচয়কে ব্যাপকভাবে পরিচিত করা উচিত। উদাহরণ স্বরূপ:
- ভবিষ্যতের দিকনির্দেশ এবং অবচয় সম্পর্কে আপনার চেঞ্জলগে একটি বিভাগ রয়েছে।
- অবমূল্যায়ন করার পূর্বে আপনার হতাশার অভিপ্রায়টি সম্প্রচার করুন এবং উল্লেখযোগ্য আপত্তি আছে কিনা তা দেখার জন্য সম্প্রদায়টিতে শুনুন।
- এই পরিবর্তনগুলি থেকে কী কী উপকার হবে তা যোগাযোগ করুন। আপনার ব্যবহারকারী বেস, নিউজলেটারস, উপস্থাপনা, ব্লগ পোস্ট, বা প্রেস রিলিজ উপর নির্ভর করে উপযুক্ত মিডিয়া হতে পারে। একটি স্পিন থাকা “আমরা একটি দুর্দান্ত বৈশিষ্ট্য তৈরি করছি! (যার জন্য বহুল ব্যবহৃত এই পুরানো বৈশিষ্ট্যটি সরানো দরকার) "প্রসঙ্গ ছাড়াই কোনও বৈশিষ্ট্য অপসারণ করার চেয়ে কিছুটা হতাশার কারণ।
সঠিক অবচয় সময় বেছে নেওয়ার ক্ষেত্রে, প্রথমে আপনার ব্যবহারকারীদের সাথে কোনও সমর্থন চুক্তি সম্মান করতে হবে কিনা তা দেখুন। এই জাতীয় চুক্তিগুলির জন্য আপনাকে কিছু সময়ের জন্য সামঞ্জস্য বজায় রাখতে হতে পারে। যদি তা না হয় তবে যে কোনও প্রবাহের প্রভাব বিবেচনা করুন। ডাউন স্ট্রিম ব্যবহারকারীদের চেয়ে কম দ্রুত পরিবর্তন করার চেষ্টা করুন যাতে তারা তাদের নিজস্ব অবচয় চক্রের মধ্য দিয়ে যেতে পারে। প্রবাহধারার ব্যবহারকারীরা আপনার পরিবর্তনের সাথে খাপ খাইয়ে নিতে কিছুটা সময় নেবেন, সুতরাং আপনার কখনই এক মাসের চেয়ে কম হ্রাস হওয়া উচিত নয়।