Skip to content

Changelog

Changelogs

Versão Unreleased changes (2026-10-29)

⚡ NOVAS FUNCIONALIDADES

  • A barra superior ganhou um seletor de fonte do texto, ao lado do alternador de tema e do seletor de idioma. São quatro opções, e duas delas existem por acessibilidade: a Atkinson Hyperlegible, desenhada para separar I/l/1 e O/0 na baixa visão, e a Do sistema, que não baixa fonte nenhuma da web e portanto funciona em máquina sem saída para a internet. A escolha vale para o site inteiro e fica guardada no navegador.
  • A barra superior passou a mostrar o repositório do projeto, com o número de estrelas e de forks, no formato padrão do mkdocs-material. Aponta para o param-manager no GitHub: este site documenta a API e o cliente, mas só o cliente tem repositório público — o do servidor foi removido do GitHub, e os dois vivem hoje num GitLab que ninguém de fora alcança.
  • A marca do Param Manager se desenha na página inicial e recomeça a cada 9 segundos, o mesmo comportamento do site do param-manager. Não há controle na tela: a animação simplesmente roda. Para quem pediu menos movimento ao sistema operacional ela não roda nem é baixada — a página mostra o quadro final, parado, e nada mais muda.
  • A página inicial ganhou os selos do projeto: versão no PyPI, linguagem, cobertura de testes e versões de Python suportadas. O de versões é estático, e não o pypi/pyversions — o pacote publicado não declara classificadores de versão, e o selo dinâmico renderiza a palavra "missing". Os selos são a única coisa do site que depende de rede externa para aparecer; sem internet o navegador mostra o texto alternativo de cada um.
  • As páginas de instalação da API e do cliente mostram o comando sendo digitado numa janela de terminal, com o resultado que ele produz. Cada bloco traz um botão para copiar o comando e outro para parar a digitação e ver a sessão inteira de uma vez. A digitação só começa quando o bloco aparece na tela, e não começa de jeito nenhum para quem pediu menos movimento — nesses casos o terminal já está escrito por inteiro, o que é também o que acontece com o JavaScript desligado.

🚀 OTIMIZAÇÕES

  • A tipografia do site foi ajustada para leitura longa: texto em Inter e código em JetBrains Mono, corpo um passo maior, entrelinha mais folgada, medida de linha limitada a cerca de 74 caracteres no parágrafo (tabelas, código e diagramas seguem usando a largura inteira) e algarismos de largura fixa nas tabelas de referência, para que versões e portas alinhem coluna a coluna. Nada é dimensionado em pixel, então o tamanho de fonte configurado no navegador continua valendo.
  • Baixar .md, salvar em PDF e escolher a fonte passaram a morar na barra superior, junto do tema, do idioma e da busca — e não mais numa faixa própria dentro do conteúdo, acima do título. São os mesmos controles, no lugar onde quem procura um controle olha primeiro, e o texto da página começa no texto da página.
  • O site mira WCAG 2.1 AA: foco visível por :focus-visible, respeito a prefers-reduced-motion, alvos de toque de 44 px, tabelas que rolam sem levar a página junto, transcrição dos blocos de terminal para leitor de tela e folha de impressão que revela o destino dos links. Não há página sobre o assunto, de propósito: o registro é o código — assets/css/a11y.css cita o critério WCAG de cada bloco, e o cabeçalho dele aponta o que vive nos scripts, fora do alcance de qualquer media query.

🐛 CORREÇÕES

  • Blocos de código voltaram a ser renderizados. O par Markdown 3.8 com pymdown-extensions 10.15, herdado do site do param-manager, fazia toda cerca genérica sair como parágrafo literal com as crases à mostra — enquanto as cercas declaradas como custom_fences, entre elas o mermaid, continuavam funcionando e o build seguia verde.
  • O site parou de pedir um versions.json que nunca existiu. A declaração extra.version.provider: mike, herdada do site do param-manager, fazia o tema buscar esse arquivo em toda página e nos dois idiomas — sempre com 404, já que o mike só o escreve depois de um mike deploy, que nunca aconteceu. O seletor de versão nem chegava a ser renderizado, então a declaração custava uma requisição falha por carregamento sem entregar nada.
  • Trocar de idioma a partir da página inicial levava a uma página que não existe. Nas páginas internas o seletor sempre funcionou, o que tornava o defeito fácil de não encontrar: só a capa estava quebrada, nos dois sentidos. O link do seletor era absoluto (/en/) e só estaria certo se o site fosse publicado na raiz do domínio — mas o mike publica cada versão sob um prefixo (/latest/), e /en/ cai fora dessa árvore. Agora o destino é sempre a página equivalente no outro idioma, em caminho relativo, em qualquer versão publicada.

📂 DOCUMENTAÇÃO

  • A documentação do produto ganhou 21 páginas cobrindo a API e o cliente em detalhe — arquitetura, endpoints, tipos de parâmetro, autenticação, cache, modo offline, empacotamento e o envelope criptográfico — cada uma em português e inglês, com botão para baixar a página em .md ou salvar em PDF.
  • As páginas do cliente passam a refletir a versão 0.6.0: Python 3.10 ou superior, sem limite superior (antes diziam "3.10 a 3.14", e o selo da página inicial agora mostra "3.10+"), e o aplicativo de desktop, que deixou de ser descrito como planejado e aparece no diagrama de arquitetura como extra da biblioteca. Também deixam de citar uma versão 0.4.3 que nunca chegou ao PyPI: o envio de user_editable só quando informado começou na 0.5.0.
  • As seções de API e Cliente ganharam fluxogramas: o caminho de uma requisição pelas camadas do servidor, e a cadeia que resolve um get_param entre cache, circuit breaker, rede e fallback local. A página de Arquitetura passou a trazer um diagrama de contexto do produto inteiro, sem repetir os dois detalhados.

🏛 INFRAESTRUTURA

  • A documentação passou a ser publicada no GitLab Pages, versionada pelo mike, em http://docs-param-manager-2714dc.pages.127.0.0.1.nip.io:8090. O job pages roda no branch padrão, grava a versão na gh-pages, empurra a branch para que as versões sobrevivam entre pipelines e extrai a árvore para o diretório que o Pages publica.
  • O task docs passou a servir em 127.0.0.1:8010. O default do mkdocs é a 8000, que neste ambiente já está ocupada, e a colisão aparecia no Windows como PermissionError: [WinError 10013] — mensagem de permissão negada que não menciona porta e manda investigar firewall à toa.
  • O arquivo da animação da marca tem 17 MB e não é carregado em toda página: ele é buscado só na página inicial, e só quando a animação vai de fato tocar. Nas outras 20 páginas do site, e para quem pediu menos movimento, ele nunca chega a ser requisitado.

🧹 LIMPEZA

  • O termynal-init.js herdado do site do param-manager não foi trazido de volta junto com o terminal e a animação. Era ele que chamava renderLogoAnimation() a cada nove segundos em toda página do site, inclusive nas que não têm animação nenhuma, onde a função nem existia — um renderLogoAnimation is not defined por carregamento, em laço. O que faz o mesmo trabalho hoje são terminal.js e logo-animation.js, que só agem na página em que o bloco existe. O extra.css e o filetree.js, órfãos desde a herança, seguem fora.