Skip to content

Atualiza README com estado real do projeto: 6 linguagens formatadas, … - #127

Merged
leonelsanchesdasilva merged 2 commits into
DesignLiquido:principalfrom
kunaaaalcodes:fix-110-readme-marketplace
Jul 29, 2026
Merged

Atualiza README com estado real do projeto: 6 linguagens formatadas, …#127
leonelsanchesdasilva merged 2 commits into
DesignLiquido:principalfrom
kunaaaalcodes:fix-110-readme-marketplace

Conversation

@kunaaaalcodes

Copy link
Copy Markdown
Contributor

Closes #110

Descrição

Esta PR atualiza o README.md para refletir com precisão o estado atual da extensão, removendo informações desatualizadas e documentando funcionalidades que já estavam implementadas, mas não eram mencionadas.

Além de corrigir a documentação existente, foi adicionada uma seção dedicada ao suporte ao Framework Líquido, tornando mais visíveis recursos já disponíveis para os usuários.

Esta alteração corresponde ao item de menor custo e maior retorno de percepção identificado no Relatório de Produtividade v0.27.5 (achado M5, severidade média).


Problema

O README.md encontrava-se desatualizado em diversos pontos:

  • diversos recursos apareciam como exclusivos da Delégua, embora já suportassem outras linguagens;
  • o suporte ao Framework Líquido não era documentado;
  • a lista de comandos, snippets, linguagens suportadas e extensões de arquivos não refletia a implementação atual;
  • novos recursos implementados nas últimas versões permaneciam invisíveis para novos usuários.

Como consequência, a documentação transmitia uma visão incompleta das capacidades da extensão.


Solução

O README foi revisado para refletir fielmente a implementação atual.

Funcionalidades

Cada seção passou a listar exatamente as linguagens atualmente suportadas.

Recurso Antes Depois
Formatação Apenas Delégua Delégua, Pituguês, Mapler, VisuAlg, Potigol e Portugol Studio
Análise semântica Apenas Delégua Delégua, Pituguês, BIRL, Mapler, VisuAlg, Portugol Studio, Potigol e delprops
Snippets Apenas Delégua Delégua (incluindo rotas Líquido), Pituguês, VisuAlg, Portugol Studio e LinConEs
Completude Apenas Delégua Delégua, Pituguês, FolEs, LMHT, VisuAlg, Portugol Studio, delprops e arquivos de teste Delégua
Tradução 4 comandos 17 comandos documentados em tabela completa
Depuração 5 linguagens 6 linguagens (incluindo Potigol)
Ícones 9 extensões 13 extensões de arquivo

Suporte ao Framework Líquido

Foi adicionada uma nova seção dedicada ao Framework Líquido, documentando funcionalidades já existentes na extensão.

Comandos

Documentação dos seis comandos disponíveis na Paleta de Comandos:

  • Iniciar servidor;
  • Novo projeto;
  • Gerar código;
  • Documentação OpenAPI;
  • Inicializar banco de dados;
  • Rodar testes.

Snippets

Documentação dos 12 snippets de rotas, incluindo:

  • rotaGet
  • rotaPost
  • rotaPut
  • rotaDelete

e demais variações disponíveis para arquivos Delégua.

Arquivos .delprops

Passam a ser documentados os recursos já existentes para arquivos de configuração:

  • destaque de sintaxe;
  • validação da configuração;
  • autocompletar;
  • documentação contextual para propriedades liquido.*.

Contexto de rotas

Documentada a análise semântica específica para arquivos localizados em rotas/, incluindo a injeção automática das variáveis:

  • liquido;
  • requisicao;
  • resposta;
  • lincones.

Task Provider

Adicionada a documentação do Task Provider utilizado para executar comandos do Framework Líquido diretamente pelo terminal integrado do VS Code.


Ajustes adicionais

Também foram realizados pequenos ajustes de organização e nomenclatura:

  • renomeação da seção "Funcionalidades até então" para "Funcionalidades";
  • renomeação da seção "Estilizador" para "Estilizador (apenas Delégua)", deixando explícito seu escopo;
  • atualização da seção da extensão Web para refletir corretamente as linguagens com suporte à formatação.

Arquivos alterados

Arquivo Descrição
README.md Atualização da documentação para refletir a implementação atual da extensão

Verificação

Foram realizadas as seguintes verificações:

  • nenhuma alteração no código-fonte;
  • atualização restrita à documentação;
  • conteúdo revisado e validado com base na implementação existente em:
    • formatadores;
    • analisadores semânticos;
    • snippets;
    • comandos;
    • provedores de completude;
    • suporte ao Framework Líquido.

Resultado

Com esta PR, o README.md passa a representar corretamente as funcionalidades atualmente disponíveis na extensão, tornando mais visíveis recursos já implementados e melhorando a experiência de novos usuários e contribuidores.


Closes #110

…8 analisadas, 17 comandos de traducao e suporte ao Liquido (DesignLiquido#110)

@leonelsanchesdasilva leonelsanchesdasilva left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Obrigado!

@leonelsanchesdasilva
leonelsanchesdasilva merged commit 88b969d into DesignLiquido:principal Jul 29, 2026
4 checks passed
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.

README e página do Marketplace escondem recursos existentes, sem menção ao Liquido

2 participants