Log de alterações e notas de versão explicadas para não desenvolvedores

Você obtém atualizações para iOS ou Android em seus smartphones. Os jogadores recebem novos patches de conteúdo para World of Warcraft ou Call of Duty. Plug-ins e temas do WordPress ganham novos recursos. O software que você usa todos os dias é atualizado periodicamente. Quando isso acontecer, um changelog é publicado que mostra exatamente o que foi corrigido ou adicionado.

O problema com esses changelogs vem com eles geralmente sendo muito difíceis de ler e entender, a menos que você seja ...

• diretamente envolvido com o projeto
• um desenvolvedor de software treinado em leitura de documentos técnicos e jargões

Para a maioria das pessoas, até mesmo a estrutura de um changelog é intimidante, o que os faz ignorar as notas por completo. Isso é ruim por vários motivos, e o menos deles é todo o fiasco dos Display Widgets e problemas como ele (que infelizmente são muito comuns).

Então, vamos analisar o que é um changelog, como ler as notas de lançamento e ter certeza de estar o mais atualizado e informado possível.

Tom e estilo

Diferentes empresas e desenvolvedores abordam seus changelogs de maneira diferente. Alguns são diretos e dizem exatamente o que a atualização faz em termos técnicos, enquanto outros (como você pode ver no exemplo abaixo de uma atualização recente do Slack) vão para uma abordagem mais legível (e frequentemente bem-humorada) para informar os usuários sobre novas coisas.

Por exemplo, WordFence é um plugin de segurança que não pode se dar ao luxo de ser irreverente em suas notas. Muitas pessoas têm muito a ver com eles, enquanto toda a marca do Slack é ser acessível e divertido.

Em geral, esses são os dois tipos de notas de versão que você verá. Se você estiver envolvido no desenvolvimento, no entanto, verá changelogs escritos de maneira muito mais obscura. A menos que você vá vasculhar o Github, provavelmente não encontrará nenhum que seja totalmente incompreensível.

A importância das questões abordadas pelas mudanças também dita o tom. Se o Slack, por exemplo, fosse vítima de uma violação de dados de uma vulnerabilidade de código (Deus me livre), as notas do patch para a correção seriam sombrias e reconfortantes.

No final, porém,

Noções básicas sobre lançamentos de pontos e números de versão

A estrutura primária de um changelog é bastante simples. Você tem um número de versão composto (geralmente) de dois ou três números separados por decimais— 2,39 ou 1.3.37 e uma lista com marcadores do que vem junto com cada versão.

Cada um desses números tem uma função específica. Nós os dividiremos em termos gerais para que você saiba o que está olhando. Porque você sempre terá notificações de que tem uma atualização pendente.

3.xx

O primeiro número em um changelog indica as versões primárias do software, os principais lançamentos, o número de vezes que o software foi lançado com melhorias significativas que alteram a funcionalidade geral.

Por exemplo, quando você atualiza o iPhone para o iOS 11, está tecnicamente atualizando para a versão 11.0.0. O mesmo vale para quando você adquire o Android Oreo - é a versão 8.0. Geralmente, quando o primeiro número de um software é atualizado, você terá uma experiência significativamente diferente da anterior.

Se você é um jogador, pense em expansões como grandes lançamentos. O primeiro lançamento de World of Warcraft em 2004 foi a versão 1.0, enquanto The Burning Crusade era 2.0, e a expansão atual, Legion, era 7.0.

Com o Divi, o lançamento de 2.7 para 3.0 foi uma reformulação do Divi Builder para o novo Visual Builder, que trouxe uma grande mudança para todos.

x.1.x

O segundo dígito é onde você vê os novos recursos que são adicionados ou os bugs corrigidos. O segundo (e terceiro) dígitos são chamados de lançamentos pontuais porque são lidos em voz alta como "sete vírgula três vírgula quatro".

Essas adições podem alterar um aspecto do aplicativo ou plug-in, mas não a funcionalidade de base como uma versão principal fará. Quando o Divi adiciona um novo módulo ou quando o iOS ou Android adiciona um novo emoji, você o obterá na versão 3.1 ou 10.3.

Para plug-ins do WordPress, dê uma olhada no Yoast SEO. A versão 5.5.0 oferece algumas correções de bugs e melhorias, mas não há nada surpreendente aqui. Basicamente, você não precisa reaprender como o software funciona com lançamentos pontuais.

Esses lançamentos pontuais ocorrerão quando você obtiver novos níveis ou sistemas em videogames. Como você pode ver abaixo, a versão 2.2. a 2.3 do aplicativo móvel Kingdom Hearts adicionou um sistema de animais de estimação. Isso não muda a forma como o jogo é jogado, mas adiciona algo em cima do que já existe.

xx7

Com o terceiro e último dígito das notas de lançamento, seu changelog provavelmente estará cheio de pequenas correções de bugs (na melhor das hipóteses). Ou provavelmente algumas mudanças / melhorias de fundo que você provavelmente não notará.

O Facebook é famoso por esses tipos de lançamentos pontuais. Seus aplicativos são atualizados semanalmente e podem alterar quase nada que (a maioria) dos usuários notará com o uso diário.

Freqüentemente, esses lançamentos pontuais são chamados de "hotfix". Esses são apenas patches que tratam de um problema que a maioria dos usuários nem sabe que existe. A maioria desses hotfixes corrige algo como uma fonte quebrada em uma determinada versão do navegador. Ou talvez um vazamento de memória em um sistema operacional específico. Freqüentemente, essas correções são rotuladas como algo genérico, como “problemas de compatibilidade”.

Às vezes, você receberá um hotfix para um problema que os desenvolvedores veem como algo que não pode esperar pelo próximo patch de conteúdo (ou atualização agendada regularmente). Novamente, isso pode ou não afetá-lo.

Como você pode ver nas atualizações feitas no Yoast de 5.3.2 para 5.3.3, as atualizações são relativamente pequenas, mas importantes em “certas situações”.

Log de mudanças na natureza

Apenas como exemplo, dê uma olhada nas notas de lançamento / changelog do Divi em alguns lançamentos principais. Entre 2.7 e 3.0.1, você pode ver os tipos de mudanças que foram feitas. Alguns principais (o lançamento do novo Visual Builder) e alguns secundários (alterações de fonte apenas para 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

No momento, estamos na versão 3.0.78 no momento desta redação. Até agora, as mudanças foram adições e ajustes relativamente sutis. Eles são importantes e incríveis, e estamos muito orgulhosos deles, mas essas 78 atualizações do lançamento do 3.0.0 até agora são iterativas para tornar a vida dos membros do Elegant Themes melhor. Quando o 3.1 chegar, você sabe que será excelente.

E 4.0? Cara, oh, cara ... nós podemos apenas imaginar.

Preste muita atenção ao seu Changelog

Você deve sempre ler o changelog que vem com qualquer plugin, aplicativo ou atualização de tema. Como observado no artigo Wordfence I ligada acima, plugins não são vendidos. Mesmo se você confiar no desenvolvedor original (e o novo pode ser igualmente confiável), você deve estar ciente dessa mudança de propriedade.

O changelog é onde você descobrirá esse tipo de coisa. Nem toda atualização e adição mudará sua experiência. No entanto, é sempre bom dar uma olhada nas notas para ver o que há de diferente. Ficar informado definitivamente vale os 30 segundos que leva para ler as notas.

E o negócio é o seguinte: se você não entende totalmente o que lê, tudo bem. Na verdade, isso é normal. Um changelog é um documento de transparência e um registro, não uma atualização trimestral ou boletim informativo por e-mail.

Embora seja perigoso dizer isso, meu sentimento é que, se você não entende o que está no changelog, então esse problema provavelmente não importa para você. (E se o fizerem, eles são importantes para outras pessoas também, que podem e irão dividi-lo para outras pessoas online.)

O importante é que você entenda a estrutura básica das notas de versão. Você deve saber o que os números e os termos significam. E eventualmente você aprenderá como fazer a varredura do changelog para encontrar as informações importantes.

Você não precisa ser um desenvolvedor (ou mesmo um técnico) para usar um changelog. Você só precisa saber o que procurar.

Miniatura do artigo por r.kathesi / shutterstock.com