Pular para o conteúdo principal

Postagens

Mostrando postagens com o rótulo JDK23

Java aprimora a documentação com suporte Markdown

Permite que os comentários da documentação do JavaDoc sejam escritos em Markdown, em vez de apenas em uma mistura de HTML e JavaDoc @-tags. JEP 467, Markdown Documentation Comments , foi promovido para ser liberado no JDK 23 Objetivos da JEP Tornar os comentários da documentação da API mais fáceis de escrever e ler no formato de origem, introduzindo a capacidade de usar a sintaxe Markdown nos comentários da documentação, juntamente com elementos HTML e tags JavaDoc. Estende a API Compiler Tree para permitir que outras ferramentas que analisam comentários de documentação manipulem o conteúdo Markdown nesses comentários. Não é o objetivo desta JEP, permitir a conversão automatizada de comentários de documentação existentes para a sintaxe Markdown. Motivação Os comentários da documentação Java tradicionalmente usam tags HTML e JavaDoc, uma escolha prática em 1995, mas desde então se tornou menos conveniente. HTML é prolixo e difícil de escrever à mão, especialmente para desenvolve