Update docs for new task runner (#3526)

Author: parlough

.gitattributes

@@ -5,9 +5,9 @@
 lib/src/version.dart linguist-generated=false
 lib/src/html/resources.g.dart linguist-generated=false
 
-# Don't force devs to manually resolve conflicts in generated files. At the end
-# of a rebase or a merge, the dev may still need to regenerate these files with
-# `dart run build_runner build` or `dart run grinder build-web`.
+# Don't force devs to manually resolve conflicts in generated files.
+# At the end of a rebase or a merge, the dev may still need to regenerate
+# these files with `dart run tool/task.dart build`.
 lib/resources/docs.dart.js merge=theirs
 lib/resources/docs.dart.js.map merge=theirs
 lib/src/generator/templates.aot_renderers_for_html.dart merge=theirs

CONTRIBUTING.md

@@ -1,58 +1,70 @@
 # Contribute to dartdoc
 
-To _use_ the dartdoc tool, see the [user docs][]. This page contains
-information relevant for contributors to the dartdoc project.
+To _use_ the dartdoc tool, see the [user docs][].
+This page contains information relevant for contributors to the dartdoc project.
 
 ## Can I help?
 
 Yes!
 
 Start by [using the tool](README.md) and filing issues and requests.
 
-See the [dartdoc API](https://pub.dev/documentation/dartdoc/latest/) docs, generated by
-dartdoc.
+See the [dartdoc API](https://pub.dev/documentation/dartdoc/latest/) docs,
+generated by dartdoc.
 
-If you want to contribute, check out the [issue tracker][] and see if there's an
-issue that you're passionate about. If you want to add a new feature that's not
-yet in the issue tracker, start by opening an issue. Thanks!
+If you want to contribute, check out the [issue tracker][] and
+see if there's an issue that you're passionate about.
+If you want to add a new feature that's not yet in the issue tracker,
+start by opening an issue. Thanks!
 
 [![Build Status](https://github.com/dart-lang/dartdoc/workflows/Test/badge.svg)](https://github.com/dart-lang/dartdoc/actions?query=workflow%3ATest)
 
 ## Making Changes
 
-1. `grind` is needed to run dartdoc integration tests, see installed via `pub global activate grinder`.
-2. When a change is user-facing, please add a new entry to the [changelog](https://github.com/dart-lang/dartdoc/blob/main/CHANGELOG.md)
-3. Please include a test for your change.  `dartdoc` has both `package:test`-style unittests as well as integration tests.  To run the unittests, use `grind test`.
-4. For major changes, run `grind compare-sdk-warnings` and `grind compare-flutter-warnings`, and include the summary results in your pull request.
-5. Be sure to format your Dart code using `dart format`, otherwise our CI will complain.
-6. Use `grind presubmit` before creating a pull request to quickly check for common problems.
-7. Post your change via a pull request for review and integration!
+1. When a change is user-facing, please add a new entry
+   to the [changelog][] under the current `-wip` version.
+2. Please include a test for your change. `dartdoc` has both
+   `package:test`-style unit tests as well as integration tests.
+   To run the tests, use `dart run tool/task.dart test`.
+3. For major changes, run both `dart run tool/task.dart compare sdk-warnings`
+   and `dart run tool/task.dart compare flutter-warnings`, and
+   include the summary results in your pull request.
+4. Be sure to format your Dart code using `dart format`,
+   otherwise our CI will complain.
+5. Use `dart run tool/task.dart buildbot` before creating a pull request
+   to quickly check for common problems.
+   Follow any instructions it outputs, then run again.
+6. Post your change via a pull request for review and integration!
 
 ## Testing
 
-dartdoc has a number of grinder utility methods that can be used to check for behavior changes
-or try out your change on arbitrary packages.
+dartdoc has a number of utility command that can be used to
+check for behavior changes or try out your change on arbitrary packages.
 
 ```bash
 # Serve the latest version of the given package locally on port 9000.
-PACKAGE_NAME=angular_components grind serve-pub-package
+dart run tool/task.dart serve package --name=intl
 
 # Build the SDK docs with the head version and compare its warning
 # output and (rough) performance to the main version.
-grind compare-sdk-warnings
+dart run tool/task.dart compare sdk-warnings
 
 # Serve the flutter docs built with the head version on port 8001.
-grind serve-flutter-docs
+dart run tool/task.dart serve flutter
 
 # Serve the test package (testing/test_package) on port 8002
-grind serve-test-package-docs
+dart run tool/task.dart serve testing-package
 ```
 
-There are more added all the time -- run `grind --help` to see them all.
+There are more commands added all the time,
+check out `tool/task.dart` to find each command or
+learn how they are implemented.
 
 ## License
 
-Please see the [dartdoc license](https://github.com/dart-lang/dartdoc/blob/main/LICENSE).
+Please see the [dartdoc license][].
 
-[user docs]: https://github.com/dart-lang/dartdoc#dartdoc
+[user docs]: https://github.com/dart-lang/dartdoc#dart-documentation-generator
 [issue tracker]: https://github.com/dart-lang/dartdoc/issues
+[changelog]: https://github.com/dart-lang/dartdoc/blob/main/CHANGELOG.md
+[dartdoc license]: https://github.com/dart-lang/dartdoc/blob/main/LICENSE

tool/task.dart

@@ -194,7 +194,7 @@ Future<void> runBuildbot() async {
 
 Future<void> runClean() async {
   // This involves deleting things, so be careful.
-  if (!File(path.join('tool', 'grind.dart')).existsSync()) {
+  if (!File(path.join('tool', 'task.dart')).existsSync()) {
     throw FileSystemException('Wrong CWD, run from root of dartdoc package');
   }
   const pubDataFileNames = {'.dart_tool', '.packages', 'pubspec.lock'};