elixir-writing-docs

| Doctests: syntax, gotchas, when to use | references/doctests.md | | Cross-references and linking syntax | references/cross-references.md | | Admonitions, formatting, tabs | references/admonitions-and-formatting.md |

ExDoc and tools like mix docs extract the first paragraph of @moduledoc and @doc as a summary. Keep the opening line concise and self-contained.

For @opaque types, the @typedoc is especially important because callers cannot inspect the structure.

指导使用 @moduledoc、@doc、@typedoc、doctests、交叉引用和元数据编写 Elixir 文档。在 .ex 文件中添加或改进文档时使用。 来源：existential-birds/beagle。