Политика устаревания публичных методов

Со временем часть публичных методов модуля Диадока 1С устаревает и заменяется новыми, более функциональными версиями. В связи с этим мы вынуждены удалять неактуальные методы и структуры без сохранения обратной совместимости спустя период устаревания.

Примечание

Период устаревания — промежуток времени между оповещением пользователей об удалении конкретных методов до их безвозвратного удаления.

Период устаревания для плановых изменений составляет 6 месяцев. Однако в некоторых ситуациях он может быть меньше:

  • если в части методов обнаружены проблемы с безопасностью, которые требуют немедленного устранения;

  • если в законодательстве произошли изменения, которые требуют отказа от части функциональности публичных методов.

В этих случаях период устаревания сокращается до срока, необходимого для внесения изменений.

Если мы планируем внести изменение, которое ломает обратную совместимость, мы обязуемся:

  • опубликовать информацию об удалении на странице История изменений не позднее, чем за время периода устаревания, и указать дату, после которой планируется удаление части публичных методов;

  • опубликовать инструкцию по миграции на актуальные версии, если они существуют;

  • отметить в документации устаревшие методы и структуры и указать дату, после которой планируется их удаление из библиотеки публичных методов;

  • записывать в Журнале регистрации информационной базы информацию о том, что вызываемый публичный метод устарел.

В течение периода устаревания мы:

  • не развиваем устаревшую функциональность, не добавляем в нее новые возможности;

  • исправляем в устаревших публичных методах только критичные проблемы, в том числе проблемы с информационной безопасностью.

После этой даты устаревшие методы и структуры могут быть безвозвратно удалены.

Перечень методов и структур, которые запланированы к удалению, приведены на странице Удаляемые методы и структуры.