mirror of
https://github.com/flutter/flutter
synced 2024-10-14 04:02:56 +00:00
37 lines
1.5 KiB
YAML
37 lines
1.5 KiB
YAML
# This file is used by dartdoc when generating API documentation for Flutter.
|
|
dartdoc:
|
|
# Before you can run dartdoc, the snippets tool needs to have a snapshot built.
|
|
# The dev/tools/dartdoc.dart script does this automatically.
|
|
tools:
|
|
snippet:
|
|
command: ["dev/snippets/lib/main.dart", "--type=snippet"]
|
|
description: "Creates sample code documentation output from embedded documentation samples."
|
|
sample:
|
|
command: ["dev/snippets/lib/main.dart", "--type=sample"]
|
|
description: "Creates full application sample code documentation output from embedded documentation samples."
|
|
dartpad:
|
|
command: ["dev/snippets/lib/main.dart", "--type=sample", "--dartpad"]
|
|
description: "Creates full application sample code documentation output from embedded documentation samples and displays it in an embedded DartPad."
|
|
errors:
|
|
# The following are always errors:
|
|
- duplicate-file
|
|
- invalid-parameter
|
|
- tool-error
|
|
- unresolved-export
|
|
# The following are elevated from warnings because we currently don't
|
|
# fail on warnings:
|
|
- ambiguous-doc-reference
|
|
- ambiguous-reexport
|
|
- ignored-canonical-for
|
|
- no-canonical-found
|
|
- not-implemented
|
|
- no-library-level-docs
|
|
- category-order-gives-missing-package-name
|
|
- reexported-private-api-across-packages
|
|
# - unresolved-doc-reference # Too many failures, needs clean-up
|
|
- broken-link
|
|
- unknown-macro
|
|
- orphaned-file
|
|
- unknown-file
|
|
- missing-from-search-index
|