|
Opuščanje obstoječe funkcionalnosti je običajen del razvoja programske opreme in je pogosto zahtevano za narediti, da se naredi nadaljnji razvoj. Ko opuščate del vašega javnega API-ja, bi morali narediti dve stvari: (1) posodobiti vašo dokumentacijo, da obvestite uporabnike o spremembi, (2) izdati novo manjšo verzijo z opuščenostjo na mestu.
|
|
Cela peut être considéré comme compatible dans la mesure où cela n’affecte pas l’API publique. Les logiciels qui dépendent des mêmes librairies que votre composant devraient avoir leur propre spécification de dépendances et l’auteur remarquera ainsi tout conflit. Pour déterminer si la modification est de niveau correctif ou mineur, il faut vous poser la question de savoir si vous avez mis à jour vos dépendances pour corriger un bug ou pour introduire une nouvelle fonctionnalité. Je considère généralement l’ajout de nouveau code comme la deuxième option ce qui sous-entend évidemment un incrément de l’identifiant de version mineure.
|
|
Eso sería considerado compatible ya que no afecta al API pública. El software que explícitamente depende de las mismas dependencias que tu paquete debiera tener sus propias especificaciones de dependencia y el autor va a notar cualquier conflicto. La determinación de si el cambio es a nivel de patch o minor depende de si actualizaste tus dependencias para arreglar un bug o para agregar funcionalidad nueva. Yo esperaría que haya código adicional si se trata de lo segundo, en cuyo caso el incremento del minor es la opción obvia.
|
|
از بهترین قضاوت خود استفاده کنید. اگر شما مخاطبان زیادی دارید که به شدت به وسیلهٔ تغییر رفتار به آنچه قبلاً برای API عمومی در نظر گرفته شده، متأثر خواهند شد، پس بهترین کار انجام یک انتشار نسخهٔ اصلی است، حتی اگر اصلاح اعمال شده مؤکداً یک انتشار وصله محسوب شود. به یاد داشته باشید، نسخهبندی معنایی تماماً دربارهٔ انتقال معنا بوسیله چگونگی تغییر عدد نسخه میباشد. اگر این تغییرات برای کاربران شما مهم است، از عدد نسخه برای آگاهسازی آنها استفاده کنید.
|
|
Označení funkcionality jako zastaralé je standardní část softwarového vývoje a většinou je to potřeba k tomu, aby šel vývoj kupředu. Když zestárne část API, měli by jste udělat dvě věci: (1) upravit dokumentaci, aby uživatelé věděli o změně, (2) vydat další MINOR verzi, která funkcionalitu “zestárne”. Předtím, než funkcionalitu kompletně odstraníte v další MAJOR verzi, měli byste vytvořit alespoň jednu MINOR verzi, která obsahuje “zestárnutí”. To umožní uživatelům hladký a snadný přechod nebo převod na nové API.
|
|
Taka aktualizacja jest uznawana za kompatybilną, gdyż nie narusza publicznego API. Oprogramowanie, które opiera się na tych samych zależnościach co twój pakiet, powinno mieć własną specyfikację zależności, a jego autor zauważy konflikt. Ustalenie, czy zmiana jest na poziomie patch lub czy jest modyfikacją na poziomie minor zależy od tego, czy zaktualizowałeś zależności w celu naprawy błędu, czy w celu wprowadzenia nowej funkcjonalności. Zazwyczaj spodziewałbym się dodatkowego kodu w tym drugim przypadku, co oczywiście oznacza zwiększenie wersji minor.
|
|
Это можно рассматривать как совместимые изменения, так как они не влияют на публичный API. ПО, которое явно зависит от тех же зависимостей что и ваш пакет, должно иметь собственные спецификации зависимостей и автор будет уведомлен о возможных конфликтах. Являются ли данные изменения уровня патча или минорного уровня, зависит от того, обновили ли вы свои зависимости чтобы исправить баг или реализовать новый функционал. В последнем случае, как правило, добавляется некоторое количество дополнительного кода и как следствие, увеличивается минорная версия.
|
|
Označenie funcionality ako zastaralej je štandardná časť softvérového vývoja a väčšinou je žiadané ísť vpred, takže k tomu jednoducho dôjde. Keď zastarávate časť svojho API, mali by ste spraviť dve veci: (1) upraviť dokumentáciu aby používatelia vedeli o zmene, (2) vydať ďalšiu MINOR verziu, ktorá funcionalitu zastaráva. A teda, predtým ako funkcionalitu kompletne odstránite v ďalšej MAJOR verzii, mali by ste spraviť aspoň jednu MINOR verziu, ktorá obsahuje zastaranie a používatelia mohli ľahko prejsť na nové API.
|
|
השתמש בשיקול הדעת שלך. אם יש לך קהל ענק שיושפע באופן גדול משינוי ההתנהגות אחורה לכוונה המקורית של ה API הציבורי, אז יכול להיות שהכי טוב יהיה לבצע שחרור של גרסה ראשית (Major), אפילו אם התיקון יכול להיחשב כגרסת תיקון (Patch) בלבד. זכור, ניהול גרסאות סמנטי הוא על העברת מסר באיך שמספר הגרסה משתנה. אם השינויים האלה חשובים למשתמשים שלך, השתמש במספר הגרסה כדי ליידע אותם.
|
|
ფუნქციონალის მოძველებულად გამოცხადება — ეს ჩვეულებრივი ამბავია დეველოპმენტის პროცესში და ხშირად აუცილებელიც კია პროდუქტის განსავითარებლად. როდესაც გარე API-ს რაიმე ნაწილს აცხადებთ მოძველებულად, თქვენ უნდა გააკეთოთ ორი რამ: (1) განაახლოთ თქვენი დოკუმენტაცია, რათა მომხმარებლებმა შეიტყონ ამ ცვლილების შესახებ; (2) გამოუშვათ ახალი რელიზი მინორული ვერსიის გაზრდით. მანამ, სანამ მთლიანად ამოიღებთ კოდიდან მოძველებულ ფუნქციონალს და დაარელიზებთ მაჟორულ ვერსიას, უნდა არსებობდეს მინიმუმ ერთი მინორული რელიზი, რომელიც შეიცავს ფუნქციონალის მოძველებულად გამოცხადებას. ეს აუცილებელია იმისათვის, რომ მომხმარებლებმა უმტკივნეულოდ შეძლონ ახალ API-ზე გადასვლა.
|