JuliaDocs/Documenter.jl

Markdown AST linting

Open

#2,059 建立於 2023年3月6日

在 GitHub 查看
 (0 留言) (1 反應) (0 負責人)Julia (513 fork)batch import
Type: Featurehelp wanted

倉庫指標

Star
 (910 star)
PR 合併指標
 (平均合併 16天 9小時) (30 天內合併 3 個 PR)

描述

There are some common errors people make with Markdown that are pretty clearly errors, but parse into valid AST (everything does), and so go unnoticed (e.g. forgetting to have closing fences for code blocks). We could implement a linting mode for Documenter, as part of docchecks, that tries to catch these.

Two steps for a useful feature:

  • A new linting step as part of docchecking. Key here is that it should be possible to disable this on its own (e.g. if you get false positives).
  • The code fence closing linter should be relatively straightforward to implement.

Suggested by @giordano: https://github.com/JuliaLang/julia/pull/48893#issuecomment-1455197197

貢獻者指南