Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

docs(upgrade): no migration notes for 0.1.1, 0.1.2, or 0.1.3 (only the 0.1.0 page exists)

Aberta Para iniciantes
  • Algo errado?
#4,398 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
65/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
graphql, helm
Domínio
documentation

Direção de pesquisa

Comece em docs/upgrade/ e use 0-1-0.mdx como referência de formato. Depois, leia as notas de versão 0.1.1, 0.1.2 e 0.1.3 e verifique os PRs vinculados #3459 (RBAC do helm), #3753 e #3841 (recusa de atualização de protocolo), além de #2798 (política de reinício do sandbox), para avaliar o impacto para operadores. Está concluído quando cada versão tiver uma página em docs/upgrade/ ou uma entrada curta informando que não é necessária migração e quais etapas da 0.1.0 ainda se aplicam.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

state:triage-needed

The docs/upgrade/ directory contains only 0-1-0.mdx. Three GA releases have shipped since (0.1.1, 0.1.2, 0.1.3) with no upgrade or migration page for any of them. A reader running 0.1.1 or later has no way to tell whether the 0.1.0 guidance still applies or what changed in their jump.

This matters most for 0.1.3, which is not a pure patch release. From the release notes it includes operator-affecting changes with no migration guidance:

  • feat(helm): make cluster-scoped RBAC optional (#3459) — changes the RBAC an operator installs.
  • fix(network): refuse protocol upgrades on JSON-RPC and MCP endpoints (#3753) and the GraphQL equivalent (#3841) — can break clients that relied on protocol upgrades.
  • feat(sandbox): add main restart policy (#2798) — changes sandbox restart behavior.

By contrast, 0.1.1 and 0.1.2 look like patch releases (fixes, docs, perf), with only minor behavior changes in 0.1.1 (WebSocket tunnel made opt-in, snap gateway mTLS). If that is correct, even a one-line "no migration steps beyond 0.1.0" note would close the gap for those two.

Request
  1. Add upgrade notes for 0.1.1, 0.1.2, and 0.1.3, even where the entry is simply "no action needed," and state which parts of the 0.1.0 guide still apply.
  2. To prevent recurrence, consider making an "upgrade impact / migration steps" entry a standard part of the release checklist, so each release either links a docs/upgrade/ page or explicitly records that no migration is required. You already publish detailed GitHub release notes (see #3732); this would add a short upgrade-impact callout rather than a new process.

Found while writing operator upgrade guidance for a downstream consumer (Red Hat Agentic Starter Kits guide) pinned at 0.1.2.

Linguagem predominante
Rust
Estrelas
15.4k
Forks
1.7k
Merge médio
1d 21h
PRs com merge (30d)
358

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de NVIDIA/OpenShell

Todas as issues de NVIDIA/OpenShell

Issues semelhantes

Mais issues de Rust

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.