Alterações
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/1eO/0na 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-managerno 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 aprefers-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.csscita 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.8compymdown-extensions 10.15, herdado do site doparam-manager, fazia toda cerca genérica sair como parágrafo literal com as crases à mostra — enquanto as cercas declaradas comocustom_fences, entre elas omermaid, continuavam funcionando e o build seguia verde. - O site parou de pedir um
versions.jsonque nunca existiu. A declaraçãoextra.version.provider: mike, herdada do site doparam-manager, fazia o tema buscar esse arquivo em toda página e nos dois idiomas — sempre com404, já que omikesó o escreve depois de ummike 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 omikepublica 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
.mdou 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_editablesó 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_paramentre 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
pagesroda no branch padrão, grava a versão nagh-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 docspassou a servir em127.0.0.1:8010. O default do mkdocs é a 8000, que neste ambiente já está ocupada, e a colisão aparecia no Windows comoPermissionError: [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.jsherdado do site doparam-managernão foi trazido de volta junto com o terminal e a animação. Era ele que chamavarenderLogoAnimation()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 — umrenderLogoAnimation is not definedpor carregamento, em laço. O que faz o mesmo trabalho hoje sãoterminal.jselogo-animation.js, que só agem na página em que o bloco existe. Oextra.csse ofiletree.js, órfãos desde a herança, seguem fora.