O changelog do Narraya: o que muda, e como o contamos
O changelog do Narraya reúne funcionalidades, melhorias, correcções e alterações breaking. Transparência pública, feed RSS, continuidade para romances longos.
O trabalho que torna um software fiável é, na maior parte dos casos, invisível. Um bug corrigido numa quinta-feira à noite não faz notícia; uma optimização que carrega uma página em 300 milissegundos em vez de 800 não aparece em newsletters. E, no entanto, são precisamente essas intervenções que, somadas, distinguem um produto maduro de um descuidado. O changelog existe para tornar esse trabalho visível — e por respeito por quem usa o Narraya todos os dias.
O que é um changelog
O changelog é uma lista pública de todas as alterações lançadas no Narraya, em ordem cronológica inversa. Vai encontrá-lo em /pt/changelog. Cada entrada indica a data de lançamento, o tipo de alteração, e uma breve descrição — suficiente para perceber se lhe diz respeito, suficientemente curta para percorrer num minuto.
Não é um diário técnico destinado a programadores. É uma comunicação dirigida aos autores que usam o Narraya: o que é novo, o que foi melhorado, o que foi corrigido, o que mudou no comportamento de certas funcionalidades.
Os quatro tipos de entrada
Cada alteração no changelog é etiquetada. A classificação, para quem tem pressa, permite-lhe saltar para o que importa: quem procura só as novidades salta as correcções; quem está atento à estabilidade consulta sobretudo estas últimas.
| Tipo | O que significa | Exemplo |
|---|---|---|
| Feature | Uma nova funcionalidade, nunca existiu antes | "Adicionado o Kanban de capítulos" |
| Improvement | Uma funcionalidade existente que passou a funcionar melhor, mais depressa, ou de forma mais clara | "A exportação em PDF é agora cerca de três vezes mais rápida" |
| Fix | Um bug resolvido: algo não funcionava como devia, agora funciona | "Corrigido um problema em que as listas aninhadas perdiam a indentação na exportação DOCX" |
| Breaking | Uma alteração que muda o comportamento de uma funcionalidade existente. Sempre assinalada em destaque | "A ficha de personagem exige agora o preenchimento obrigatório do campo Nome" |
As alterações breaking são as mais raras — e também as mais delicadas. Quando uma mudança altera o modo como algo se comportava, comunicamo-la com antecedência: por email aos utilizadores afectados, em destaque no changelog, e muitas vezes com um período de "compatibilidade dupla" durante o qual o velho e o novo coexistem. Não queremos que abra o Narraya numa segunda-feira e descubra que um hábito no qual construiu as suas sessões desapareceu sem aviso.
Como ler o changelog
Não precisa de o ler integralmente todas as vezes. Para a maior parte dos utilizadores, três abordagens funcionam bem, consoante o momento:
- Verificação semanal. Todas as segundas-feiras de manhã, dois minutos: percorra as entradas da semana, veja se algo de novo lhe diz respeito. Torna-se um hábito ligeiro.
- Consulta ocasional. Quando lhe parece que um comportamento mudou, verifique o changelog. Muitas vezes a resposta está ali, com a data exacta e uma breve explicação.
- Vista panorâmica após pausas. Se regressa ao Narraya depois de um mês de viagens ou de bloqueio criativo, uma leitura do último mês do changelog reorienta-o melhor do que qualquer newsletter.
Para não ter de abrir o changelog manualmente, existe um feed RSS dedicado. Adicione-o ao seu agregador preferido e receberá apenas as actualizações importantes — sem emails, sem notificações push. O link para o feed está ao fundo da página do changelog. Uma forma sóbria de se manter informado: o Narraya respeita-o também na maneira como comunica consigo.
Porquê não pôr tudo em notas de lançamento dentro do Narraya
Uma pergunta justa: porquê um changelog público, em vez de um "anúncio das novidades" dentro da própria aplicação? Por duas razões. A primeira é que muitos não querem ser interrompidos enquanto escrevem por popups que celebram funcionalidades novas. O momento da escrita é sagrado; as novidades podem esperar o próximo intervalo de café. A segunda é que um changelog público é consultável mesmo por quem ainda não é utilizador do Narraya: quem está a avaliar a plataforma pode ver, de forma transparente, quanto trabalhamos nela e o que estamos a fazer.
Continuidade para quem escreve um romance longo
Há uma coisa a que damos especial atenção: a continuidade. Se está a escrever um romance no Narraya há oito meses, as alterações que introduzimos não devem assustá-lo. Por isso, no changelog pode sempre ver a lista completa do que foi tocado — e se algo diz respeito a uma funcionalidade que usa, perceber se o seu fluxo de trabalho se mantém igual ou se terá de o adaptar.
Um bom changelog é, de certo modo, um contrato de continuidade entre quem constrói o produto e quem vive dentro dele. Dizemos-lhe tudo. Explicamos o que muda. Avisamos com antecedência se algo importante se está a mover. É a forma como um projecto pequeno como o nosso pode merecer a confiança necessária para acompanhar romances que levam anos. Não pedimos confiança cega: construímo-la entrada a entrada, no changelog.
Consulte o changelog actualizado sempre que quiser. Subscreva o feed RSS ao fundo da página se preferir uma leitura assíncrona, silenciosa, que respeita o seu tempo.