Validar a sintaxe ou justificar o incremento da versão?
SemVer verifica apenas sintaxe. Decida a compatibilidade pelas alterações reais; use a revisão de versões de API quando contratos forem modificados.
Elysia Tools
Navegação
Workflow Playbook
Revise uma versão pelo registro de alterações, valide a sintaxe e as referências Markdown e prepare notas consistentes para site, Slack e PDF.
Novo neste fluxo? Siga os passos em ordem, começando pela primeira ferramenta abaixo. Já sabe o que precisa? Vá direto ao passo correspondente: todas as ferramentas deste fluxo estão na tabela comparativa.
Primeira ferramenta: Extrator de Registro de Alterações
Temas
Temas
| Ferramenta | O que faz | Categoria |
|---|---|---|
| Extrator de Registro de Alterações | Analisa e extrai dados estruturados de registros de alterações e notas de versão em vários formatos | Development |
| Validador SemVer |
Ferramentas de processamento, conversão e otimização de imagens, áudio e vídeo
Calculadoras, ferramentas numéricas, lógica de datas, estatística e finanças
Ferramentas de cor, layout, gráficos, estilo visual e apoio ao design
Ferramentas de escrita, limpeza, formatação, extração e análise de texto
Utilitários para desenvolvedores, rede, depuração web e automação
Ferramentas de conversão de formatos, arquivos, unidades, arquivos compactados e codificação
Este fluxo atende responsáveis que entregam uma versão de software a revisores e encarregados dos anúncios. Comece pelo registro oficial e uma versão definida, não por mensagens de alterações misturadas. Extraia as seções, confira datas e categorias e compare as entradas com evidências aprovadas. Uma seção vazia pode indicar formato não reconhecido, não ausência de mudanças. Não inclua automaticamente todos os itens ainda não publicados.
Explique o que mudou, quem precisa agir e quais orientações de migração ou reversão estão aprovadas. Sintaxe SemVer válida não justifica um incremento secundário. Resolva isso antes da publicação. O verificador de estilo localiza defeitos de formato; correções seguras não substituem a revisão de títulos, exemplos de código e explicações incompletas. Fixe a revisão de origem antes de criar variantes.
Notas curtas normalmente dispensam sumário. Para documentos longos, finalize os títulos antes de gerá-lo e confira as referências depois. As âncoras seguem convenções do GitHub; teste-as no renderizador real do site. Uma verificação estática não comprova que um download está disponível. Abra os destinos externos importantes separadamente e confira exigências de autenticação.
Produza apenas os formatos necessários. Uma tabela extensa pode permanecer nas notas completas; no Slack, mantenha um resumo legível com avisos de migração e link oficial. Reescreva tabelas, listas de tarefas e explicações dependentes de imagens quando forem sinalizadas como não suportadas. Converter não equivale a implantar o site nem enviar mensagens.
Quando houver necessidade de PDF, examine páginas reais para encontrar tabelas cortadas, código fora das margens e contexto perdido nas quebras. Compare versão, data, instruções e links de cada entrega com o documento principal. Regenere variantes antigas em vez de corrigir só o arquivo exportado. Registre revisão aprovada e nomes de arquivos juntos. Manuais amplos pertencem ao fluxo de documentação; ajustes isolados, aos utilitários Markdown. A compatibilidade de contratos deve ser decidida na revisão de versões de API antes desta entrega.
Guia de fluxo de trabalho
SemVer verifica apenas sintaxe. Decida a compatibilidade pelas alterações reais; use a revisão de versões de API quando contratos forem modificados.
| Valida números de versão conforme Semantic Versioning 2.0.0 (formato x.y.z-alpha.1) |
| Validation |
| Verificador de Estilo e Lint de Markdown | Verifica o Markdown com ~15 regras markdownlint mais 2 regras de tipografia chinesa, com relatório por linha e auto-correção de problemas seguros | Text Processing |
| Gerador de TOC Markdown | Gera um sumário a partir dos cabeçalhos Markdown com links de âncora estilo GitHub | Format Conversion |
| Verificador de Links Markdown | Verifica estaticamente links Markdown por erros de formato, âncoras quebradas e referências indefinidas (sem requisições de rede) | Development |
| Conversor Markdown para HTML | Converte texto Markdown para HTML com opções de formato personalizáveis | Format Conversion |
| Markdown para Slack mrkdwn | Converte Markdown no estilo GitHub em mrkdwn para Slack e marca estruturas sem suporte | Format Conversion |
| Pacote de Temas Markdown para PDF | Converte Markdown em PDF com temas claro, escuro ou impressão | Document Tools |
Extraia versões e alterações classificadas, selecione a publicação prevista, compare com as evidências e valide o identificador sem tratar sintaxe como prova de compatibilidade.
Corrija problemas de formatação, examine títulos e blocos de código manualmente e complete explicações de mudanças e migração.
Gere um sumário apenas quando útil; depois verifique âncoras internas, formatos e referências indefinidas. Teste URLs externas e âncoras específicas do destino separadamente.
Converta o documento aprovado para HTML e o anúncio para Slack mrkdwn, adapte elementos não suportados e compare fatos essenciais antes da entrega, sem publicação automática.
Exporte um PDF com tema adequado, confira paginação e leitura e compare os arquivos necessários com a mesma revisão aprovada.
Dispense-o em anúncios curtos. Em notas extensas, finalize os títulos antes de gerar a navegação e teste as âncoras no destino.
Preserve o contexto no site ou PDF. Encurte o Slack sem perder avisos de migração e o link oficial; adapte tabelas e listas de tarefas não suportadas.
Extraia material de codigo, PDF ou HTML e depois organize, revise, visualize e exporte uma documentacao pronta para publicar.
Limpe a estrutura Markdown, revise links, junte arquivos, visualize, traduza artigos e exporte entregaveis em HTML, PDF, slides, texto ou JSON.
Compare versoes de API, planeje migracoes e aceite a compatibilidade antes do release. As ferramentas nao substituem o deploy real nem o monitoramento.
Verifica o Markdown com ~15 regras markdownlint mais 2 regras de tipografia chinesa, com relatório por linha e auto-correção de problemas seguros
Gera um sumário a partir dos cabeçalhos Markdown com links de âncora estilo GitHub
Verifica estaticamente links Markdown por erros de formato, âncoras quebradas e referências indefinidas (sem requisições de rede)
Converte texto Markdown para HTML com opções de formato personalizáveis
Converte Markdown no estilo GitHub em mrkdwn para Slack e marca estruturas sem suporte
Converte Markdown em PDF com temas claro, escuro ou impressão