Skip to content

docs: refresh README + site for v0.2.51 - #1050

Merged
milkway merged 1 commit into
mainfrom
docs/v0251-readme-site
Jul 30, 2026
Merged

docs: refresh README + site for v0.2.51#1050
milkway merged 1 commit into
mainfrom
docs/v0251-readme-site

Conversation

@milkway

@milkway milkway commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Primeira de duas PRs de doc para a v0.2.51 (README + páginas do site). A outra cobre arquitetura, roadmaps e diagramas — arquivos disjuntos, de propósito, para poderem ser revisadas em paralelo.

Implementada por agente codex exec (gpt-5.6-sol, high); revisada por mim.

Defasagem que motivou a PR

O README fixava Current release: [v0.2.49] mais um link de referência. Isso viola a política do próprio repositório — nenhuma string de versão atual fora do news.md — e já estava duas releases atrás. Removido, não atualizado para 0.2.51: o problema era o hardcode existir, não o número estar velho. A página de releases já identifica a versão corrente.

O que passou a estar documentado

As três entregas da v0.2.51, no README e nas páginas afetadas (introduction, quickstart, installation, use-cases, faq, deploying, troubleshooting, migrating, alternatives):

  • Timestamps da admin no fuso de quem olha, com ordenação por instante.
  • server.timezone para o agendador, com ausente ⇒ UTC dito explicitamente, para ninguém temer que atualizar mova um agendamento.
  • Editores escopados por grupo, incluindo o que permanece Admin-only e o 404 deliberado.

Destaque do FAQ: ele separa os dois relógios, que é a confusão mais provável desta release — tabelas seguem o navegador do viewer; o agendador segue server.timezone, porque cron não tem viewer.

Verificações da minha revisão

  • Uma afirmação acionável testada, não suposta. A doc manda rodar ruscker validate após mexer no fuso. Rodei com timezone: BRT e o warning sai correto, nomeando a zona e avisando que os jobs continuam em UTC. Se não saísse, a instrução seria letra morta.
  • Políticas conferidas por grep no diff: nenhuma seta solta 540 → 14, o bloco de footprint segue liderando com ~14 MB ancorado ao "JVM-based proxy it replaced", nenhuma menção a órgão ou servidor, nenhuma versão nova introduzida.
  • mdbook build book passa; o diretório de saída segue ignorado pelo git.
  • Só os dez arquivos autorizados foram tocados.

Divergência que o agente encontrou (e documentou como intenção)

Na aba Logs o hover preserva o token UTC bruto, enquanto as tabelas mostram a data localizada completa. Isso foi decisão minha ao implementar o #1041: o log baixado é UTC, então manter o token cru permite correlacionar linha e arquivo. A doc descreve o comportamento real e explica o porquê, em vez de assumir simetria que não existe.

🤖 Generated with Claude Code

@milkway
milkway merged commit fa6491a into main Jul 30, 2026
4 checks passed
@milkway
milkway deleted the docs/v0251-readme-site branch July 30, 2026 01:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant