blob: f73d4570c3fec37a3143b7371da704f105312daa [file] [log] [blame]
Greg Spencer65d3ddd2018-10-23 13:50:24 -07001# This file is used by dartdoc when generating API documentation for Flutter.
2dartdoc:
Greg Spencer10e4b042021-08-11 19:48:29 -07003 # Before you can run dartdoc, the snippets tool needs to be
4 # activated with "pub global activate snippets <version>"
5 # The dev/bots/docs.sh script does this automatically.
Greg Spencer65d3ddd2018-10-23 13:50:24 -07006 tools:
7 snippet:
Greg Spencera7310dc2021-08-30 12:16:05 -07008 command: ["bin/cache/dart-sdk/bin/dart", "pub", "global", "run", "snippets", "--output-directory=doc/snippets", "--type=snippet"]
Greg Spencerfabf4e32020-01-08 15:28:02 -08009 description: "Creates sample code documentation output from embedded documentation samples."
Greg Spencer65d3ddd2018-10-23 13:50:24 -070010 sample:
Greg Spencera7310dc2021-08-30 12:16:05 -070011 command: ["bin/cache/dart-sdk/bin/dart", "pub", "global", "run", "snippets", "--output-directory=doc/snippets", "--type=sample"]
Greg Spencerfabf4e32020-01-08 15:28:02 -080012 description: "Creates full application sample code documentation output from embedded documentation samples."
Andrew Brogdon69197772019-09-10 08:36:14 -070013 dartpad:
Greg Spencera7310dc2021-08-30 12:16:05 -070014 command: ["bin/cache/dart-sdk/bin/dart", "pub", "global", "run", "snippets", "--output-directory=doc/snippets", "--type=dartpad"]
Greg Spencerfabf4e32020-01-08 15:28:02 -080015 description: "Creates full application sample code documentation output from embedded documentation samples and displays it in an embedded DartPad."
Michael Goderbauer4b4287b2020-07-23 08:29:46 -070016 errors:
Michael Goderbauer6ca8fda2020-07-30 14:11:23 -070017 # Default errors of dartdoc:
Michael Goderbauerf4e10b42020-07-28 16:11:04 -070018 - duplicate-file
19 - invalid-parameter
Michael Goderbauer923eb762020-09-22 12:57:13 -070020 - no-defining-library-found
Michael Goderbauerf4e10b42020-07-28 16:11:04 -070021 - tool-error
22 - unresolved-export
Michael Goderbauer6ca8fda2020-07-30 14:11:23 -070023 # Warnings that are elevated to errors:
Michael Goderbauerf4e10b42020-07-28 16:11:04 -070024 - ambiguous-doc-reference
25 - ambiguous-reexport
Michael Goderbauerf4e10b42020-07-28 16:11:04 -070026 - broken-link
Michael Goderbauer6ca8fda2020-07-30 14:11:23 -070027 - category-order-gives-missing-package-name
Michael Goderbauer923eb762020-09-22 12:57:13 -070028 - deprecated
Michael Goderbauer6ca8fda2020-07-30 14:11:23 -070029 - ignored-canonical-for
Michael Goderbauerf4e10b42020-07-28 16:11:04 -070030 - missing-from-search-index
Michael Goderbauer6ca8fda2020-07-30 14:11:23 -070031 - no-canonical-found
Janice Collinse9a9a612020-10-07 08:47:05 -070032 - no-documentable-libraries
Michael Goderbauer6ca8fda2020-07-30 14:11:23 -070033 - no-library-level-docs
34 - not-implemented
Michael Goderbauer6ca8fda2020-07-30 14:11:23 -070035 - orphaned-file
Michael Goderbauer94f76d62020-07-31 10:01:03 -070036 - reexported-private-api-across-packages
Michael Goderbauer923eb762020-09-22 12:57:13 -070037 # - unknown-directive # Disabled due to https://github.com/dart-lang/dartdoc/issues/2353
Michael Goderbauer94f76d62020-07-31 10:01:03 -070038 - unknown-file
39 - unknown-macro
40 - unresolved-doc-reference