Документация одновременно с обновлениями.

Рейтинг: 1.1615  
Отложено
Предложил Korban Michael 28.05.2014 14:09:17

Документация одновременно с обновлениями.

Сегодня столкнулся с неприятной ситуацией, когда после очередного "стабильного" обновления перестал работать код:

$res = CTasks::GetList(
                    Array("ID" => "ASC"),
                    Array(
                        "RESPONSIBLE_ID" => $userId,
                        "FORUM_ID" => $forumId
                    )
                );
 
Как оказалось, теперь поле FORUM_ID не является допустимым для использования в фильтре, однако в документации это не отражено, в результате чего пришлось изучать исходный код в поисках причины пропавшей работоспособности.

Ранее об этом уже упоминалось, но хочется еще раз поднять вопрос о том, что бы для обновлений был максимально подробный changelog, что бы было понятно заранее к чему готовится. Кроме этого, я бы предпочел, и думаю, что я не один такой буду, кто был бы готов подождать обновлений, но зато что все изменения были задокументированы.
Рейтинг: 0  
Ответил Басыров Роберт 04.12.2014 19:01:50
Это нереализуемо. Новый функционал редко когда выходит в полном заявленном объёме, тем более бывает что пропускаются ошибки.
Разработчики откладывают написание доки до появления реально стабильной работы своих модулей.