dartdoc_options.yaml 1.89 KB
Newer Older
1 2
# This file is used by dartdoc when generating API documentation for Flutter.
dartdoc:
3 4 5
  # Before you can run dartdoc, the snippets tool needs to be
  # activated with "pub global activate snippets <version>"
  # The dev/bots/docs.sh script does this automatically.
6 7
  tools:
    snippet:
8
      command: ["bin/cache/dart-sdk/bin/dart", "pub", "global", "run", "snippets", "--output-directory=doc/snippets", "--type=snippet"]
9
      description: "Creates sample code documentation output from embedded documentation samples."
10
    sample:
11
      command: ["bin/cache/dart-sdk/bin/dart", "pub", "global", "run", "snippets", "--output-directory=doc/snippets", "--type=sample"]
12
      description: "Creates full application sample code documentation output from embedded documentation samples."
13
    dartpad:
14
      command: ["bin/cache/dart-sdk/bin/dart", "pub", "global", "run", "snippets", "--output-directory=doc/snippets", "--type=dartpad"]
15
      description: "Creates full application sample code documentation output from embedded documentation samples and displays it in an embedded DartPad."
16
  errors:
17
    ## Default errors of dartdoc:
18 19 20 21
    - duplicate-file
    - invalid-parameter
    - tool-error
    - unresolved-export
22
    ## Warnings that are elevated to errors:
23 24
    - ambiguous-doc-reference
    - ambiguous-reexport
25 26
    - broken-link
    - category-order-gives-missing-package-name
27
    - deprecated
28
    - ignored-canonical-for
29
    - missing-from-search-index
30
    - no-canonical-found
31
    - no-documentable-libraries
32
    - no-library-level-docs
33
    - orphaned-file
34 35
    - reexported-private-api-across-packages
    - unknown-file
36
    - unknown-macro
37
    - unresolved-doc-reference
38
    ## Ignores that are elevated to errors:
39 40 41
    # - type-as-html # broken, https://github.com/dart-lang/dartdoc/issues/3545
    - missing-constant-constructor
    # - missing-code-block-language # blocked on https://github.com/dart-lang/matcher/pull/230