feat(aft): Docs commands

Adds `aft docs build` and `aft docs serve` to compile docs and serve docs on a local HTTP server with auto-rebuild, respectively.

Author: Dillon Nys

.gitignore

@@ -18,6 +18,8 @@ temp/
 .fvm/
 .packages
 pubspec_overrides.yaml
+doc/api/
+**/doc/api/
 
 # IDEs
 .idea/

aft.yaml

@@ -152,30 +152,3 @@ scripts:
       if [ -d android ]; then
         flutter build apk --debug
       fi
-  build:docs:
-    description: Builds the documentation examples
-    run: |
-      if [ ! -f doc/build.yaml ]; then
-        echo "No documentation examples for {{ package.name }}" >&2
-        exit 0
-      fi
-
-      pushd doc
-      # All `doc` packages should allow `flutter` dependencies even if they 
-      # are subpackages of a Dart-only package. For example, we want to use 
-      # `amplify_flutter` in the `amplify_core` docs.
-      flutter pub get
-      flutter pub run build_runner build
-      popd
-
-      if [ "{{ package.flavor }}" == "flutter" ]; then
-        PUB="flutter pub"
-      else
-        PUB="dart"
-      fi
-
-      $PUB run code_excerpt_updater \
-        --fragment-dir-path=doc/.dart_tool/build/generated \
-        --yaml \
-        --write-in-place \
-        lib

packages/aft/README.md

@@ -12,6 +12,9 @@ A CLI tool for managing the Amplify Flutter repository.
   - `update`: Updates constraints in `aft.yaml` to match latest in `pub.dev`
   - `apply`: Applies constraints in `aft.yaml` to all repo packages
   - `pub-verify`: Verifies Amplify constraints against the top pub.dev packages
+- `docs`: Develop package documentation
+  - `build`: Builds documentation for packages
+  - `serve`: Serves package documentation for local development
 - `exec`: Execute a command in all repo packages
 - `generate`: Generates various repo items
   - `workflows`: Generates GitHub actions workflows for all packages in the repo

packages/aft/lib/aft.dart

@@ -8,6 +8,7 @@ export 'src/commands/bootstrap_command.dart';
 export 'src/commands/clean_command.dart';
 export 'src/commands/constraints_command.dart';
 export 'src/commands/create_command.dart';
+export 'src/commands/docs_command.dart';
 export 'src/commands/exec_command.dart';
 export 'src/commands/generate/generate_command.dart';
 export 'src/commands/link_command.dart';

packages/aft/lib/src/command_runner.dart

@@ -36,7 +36,8 @@ Future<void> run(List<String> args) async {
     ..addCommand(ExecCommand())
     ..addCommand(CreateCommand())
     ..addCommand(SaveRepoStateCommand())
-    ..addCommand(RunCommand());
+    ..addCommand(RunCommand())
+    ..addCommand(DocsCommand());
 
   try {
     final argResults = runner.argParser.parse(args);