Список изменений и примечания к выпуску, объясненные для лиц, не являющихся разработчиками

Вы получаете обновления iOS или Android на свои смартфоны. Геймеры получат новые обновления контента для World of Warcraft или Call of Duty. Плагины и темы WordPress получили новые функции. Программное обеспечение, которое вы используете каждый день, периодически обновляется. Когда это происходит, публикуется журнал изменений, в котором показано, что именно было исправлено или добавлено.

Проблема с этими журналами изменений заключается в том, что их часто очень трудно читать и понимать, если вы не ...

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

Для большинства людей даже структура журнала изменений пугает, что заставляет их полностью игнорировать заметки. Это плохо по ряду причин, не в последнюю очередь из-за полного провала Display Widgets и подобных проблем (которые, к сожалению, довольно распространены).

Итак, давайте разберемся, что такое журнал изменений, как читать примечания к выпуску, и позаботимся о том, чтобы вы оставались как можно более актуальными и информированными.

Тон и стиль

Разные компании и разработчики по-разному подходят к своим журналам изменений. Некоторые из них просты и рассказывают вам, что именно делает обновление с технической точки зрения, в то время как другие (как вы можете видеть в приведенном ниже примере из недавнего обновления Slack) используют более читаемый (и часто юмористический) подход к информированию пользователей о новых материалах.

Например, WordFence - это плагин безопасности, который не может позволить себе быть легкомысленным в своих заметках. Слишком много людей слишком много катаются на них, в то время как весь бренд Slack - это доступность и веселье.

В общем, это два вида примечаний к выпуску, которые вы увидите. Однако, если вы участвуете в разработке, вы увидите гораздо более неясно написанные журналы изменений. Если вы не копаетесь в Github, вы вряд ли найдете что-то совершенно непонятное.

Важность решаемых изменений также диктует тон. Если бы Slack, например, стал жертвой утечки данных из-за уязвимости кода (не дай Бог), примечания к патчу для исправления были бы мрачными и обнадеживающими.

Но в конце концов,

Общие сведения о выпусках и номерах версий

Основная структура журнала изменений довольно проста. У вас есть номер версии, составленный (обычно) из двух или трех чисел, разделенных десятичными знаками - 2.39 или 1.3.37, и маркированный список того, что идет вместе с каждым выпуском.

У каждого из этих чисел есть своя функция. Мы разберем их в общих чертах, чтобы вы знали, на что смотрите. Потому что у вас всегда будут уведомления о том, что у вас есть ожидающие обновления.

3.xx

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

Например, когда вы обновляете iPhone до iOS 11, вы технически обновляетесь до версии 11.0.0. То же самое с Android Oreo - это версия 8.0. Как правило, при обновлении первого номера программного обеспечения вы получите значительно иной опыт, чем раньше.

Если вы геймер, думайте о расширениях как о главных выпусках. Первым выпуском World of Warcraft в 2004 году была версия 1.0, The Burning Crusade - 2.0, а текущее расширение Legion - 7.0.

В Divi выпуск с 2.7 по 3.0 представлял собой переработку Divi Builder в совершенно новый Visual Builder, что привело к большим изменениям для всех.

x.1.x

Вторая цифра - это место, где вы видите добавление новых функций или исправление ошибок. Вторая (и третья) цифры называются точками сброса, потому что они читаются вслух как «семь целых три и четыре десятых».

Эти дополнения могут изменить аспект приложения или плагина, но не базовую функциональность, как это сделает основной выпуск. Когда Divi добавит новый модуль или когда iOS или Android добавят новые эмодзи, вы получите его в версии 3.1 или 10.3.

Для плагинов WordPress обратите внимание на Yoast SEO. Версия 5.5.0 содержит несколько исправлений ошибок и улучшений, но здесь нет ничего грандиозного. По сути, вам не нужно заново изучать, как программное обеспечение работает с точечными выпусками.

Эти точечные релизы будут, когда вы получите новые уровни или системы в видеоиграх. Как видно ниже, версия 2.2. В 2.3 мобильного приложения Kingdom Hearts добавлена ​​система питомцев. Это не меняет , как игра играет, но добавляет что - то сверх того , что там уже.

xx7

С третьей и последней цифрой примечаний к выпуску ваш журнал изменений, вероятно, будет полон мелких исправлений ошибок (в лучшем случае). Или, возможно, некоторые фоновые изменения / улучшения, которые вы, вероятно, не заметите.

Facebook печально известен такими точечными релизами. Их приложения обновляются еженедельно, и они могут практически ничего не изменить, что (большинство) пользователей заметят при ежедневном использовании.

Часто эти второстепенные выпуски представляют собой так называемые «исправления». Это просто исправления, которые решают проблему, о существовании которой большинство пользователей даже не подозревает. Большинство этих исправлений исправляют что-то вроде сбоя шрифта в определенной версии браузера. Или, может быть, утечка памяти в конкретной операционной системе. Часто эти исправления обозначаются как «проблемы совместимости».

Иногда вы получаете исправление для проблемы, которую разработчики считают проблемой, которая не может дождаться следующего обновления содержимого (или регулярного запланированного обновления). Опять же, это может или не может повлиять на вас.

Как вы можете видеть в обновлениях Yoast с 5.3.2 по 5.3.3, обновления относительно незначительны, но важны в «определенных ситуациях».

Журнал изменений в дикой природе

В качестве примера взгляните на примечания к выпуску / журнал изменений для Divi по нескольким основным выпускам. Между 2.7 и 3.0.1 вы можете видеть, какие изменения были внесены. Некоторые крупные (выпуск нового Visual Builder) и некоторые второстепенные (изменения шрифтов только для WordPress 4.6).

version 3.0.1 ( updated 09-08-2016 )
- Fixed various third party module conflicts in the Visual Builder.
- The save button will now appear automatically when attempting to leave the Visual Builder without saving.
- Fixed issue with content width misalignment in the Visual Builder while boxed layout was enabled.
- Fixed occurrences where the in-line editor did not save properly
- Added footer credits editor to Theme Customizer.
- Fixed issues with IE11 and the Slider Module when viewed inside the Visual Builder.
- Fixed problem with the rendering of the divider module height setting in the Visual Builder.
	

version 3.0 ( updated 09-07-2016 )
- Introducing the brand new Visual Builder: https://www.elegantthemes.com/blog/theme-releases/divi-3

version 2.7.10 ( updated 08-18-2016 )
- Fixed the issue with the Divi Builder not loading on some websites due to loading delay of TinyMCE in the latest version of WordPress.


version 2.7.9 ( updated 08-15-2016 )
- Fixed settings page font issues in WordPress 4.6

На момент написания этой статьи мы находимся на версии 3.0.78. До сих пор изменения были относительно тонкими дополнениями и настройками. Они важны и прекрасны, и мы очень гордимся ими, но эти 78 обновлений с момента выпуска 3.0.0 до настоящего времени являются повторяющимися, чтобы улучшить жизнь участников Elegant Themes. Когда выйдет 3.1, вы знаете, что он будет превосходным.

А 4.0? Блин, блин… мы можем только вообразить.

Обратите пристальное внимание на свой журнал изменений

Вы всегда должны читать журнал изменений, который поставляется с любым обновлением плагина, приложения или темы. Как было отмечено в статье Wordfence я связан выше, плагины действительно становятся проданы. Даже если вы доверяете первоначальному разработчику (а новый может быть таким же заслуживающим доверия), вы должны знать об этом изменении владельца.

Журнал изменений - это то место, где вы узнаете о подобных вещах. Не каждое обновление и добавление изменит ваш опыт. Тем не менее, всегда полезно хотя бы взглянуть на заметки, чтобы увидеть, в чем разница. Чтобы оставаться в курсе, определенно стоит потратить 30 секунд на чтение заметок.

И вот в чем дело: если вы не до конца понимаете, что читаете, ничего страшного. На самом деле это нормально. Журнал изменений - это документ для прозрачности и запись, а не ежеквартальное обновление или информационный бюллетень по электронной почте.

Хотя об этом и опасно говорить, я считаю, что если вы не понимаете, что находится в журнале изменений, то эта проблема, вероятно , для вас не имеет значения. (И если они это сделают, они имеют значение и для других людей, которые могут и будут разбирать это для других в Интернете.)

Важно то, что вы понимаете основную структуру примечаний к выпуску. Вы должны знать, что означают цифры и термины. И со временем вы научитесь сканировать журнал изменений, чтобы найти важную информацию.

Вам не нужно быть разработчиком (или даже технарем), чтобы использовать журнал изменений. Вам просто нужно знать, что искать.

Миниатюра статьи r.kathesi / shutterstock.com