Share gitignore file across repo and add analyze analysis_defaults

.github/workflows/dart.yml

@@ -39,16 +39,16 @@ jobs:
       - name: mono_repo self validate
         run: dart pub global run mono_repo generate --validate
   job_002:
-    name: "analyzer_and_format; Dart 3.5.0; PKGS: pkgs/excerpter, pkgs/inject_dartpad; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos .`"
+    name: "analyzer_and_format; Dart 3.5.0; PKGS: pkgs/analysis_defaults, pkgs/excerpter, pkgs/inject_dartpad; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos .`"
     runs-on: ubuntu-latest
     steps:
       - name: Cache Pub hosted dependencies
         uses: actions/cache@0c45773b623bea8c8e75f6c82b208c3cf94ea4f9
         with:
           path: "~/.pub-cache/hosted"
-          key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/excerpter-pkgs/inject_dartpad;commands:format-analyze"
+          key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/analysis_defaults-pkgs/excerpter-pkgs/inject_dartpad;commands:format-analyze"
           restore-keys: |
-            os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/excerpter-pkgs/inject_dartpad
+            os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/analysis_defaults-pkgs/excerpter-pkgs/inject_dartpad
             os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
             os:ubuntu-latest;pub-cache-hosted
             os:ubuntu-latest
@@ -59,6 +59,19 @@ jobs:
       - id: checkout
         name: Checkout repository
         uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938
+      - id: pkgs_analysis_defaults_pub_upgrade
+        name: pkgs/analysis_defaults; dart pub upgrade
+        run: dart pub upgrade
+        if: "always() && steps.checkout.conclusion == 'success'"
+        working-directory: pkgs/analysis_defaults
+      - name: "pkgs/analysis_defaults; dart format --output=none --set-exit-if-changed ."
+        run: "dart format --output=none --set-exit-if-changed ."
+        if: "always() && steps.pkgs_analysis_defaults_pub_upgrade.conclusion == 'success'"
+        working-directory: pkgs/analysis_defaults
+      - name: "pkgs/analysis_defaults; dart analyze --fatal-infos ."
+        run: dart analyze --fatal-infos .
+        if: "always() && steps.pkgs_analysis_defaults_pub_upgrade.conclusion == 'success'"
+        working-directory: pkgs/analysis_defaults
       - id: pkgs_excerpter_pub_upgrade
         name: pkgs/excerpter; dart pub upgrade
         run: dart pub upgrade
@@ -86,16 +99,16 @@ jobs:
         if: "always() && steps.pkgs_inject_dartpad_pub_upgrade.conclusion == 'success'"
         working-directory: pkgs/inject_dartpad
   job_003:
-    name: "analyzer_and_format; Dart dev; PKGS: pkgs/excerpter, pkgs/inject_dartpad; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos .`"
+    name: "analyzer_and_format; Dart dev; PKGS: pkgs/analysis_defaults, pkgs/excerpter, pkgs/inject_dartpad; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos .`"
     runs-on: ubuntu-latest
     steps:
       - name: Cache Pub hosted dependencies
         uses: actions/cache@0c45773b623bea8c8e75f6c82b208c3cf94ea4f9
         with:
           path: "~/.pub-cache/hosted"
-          key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/excerpter-pkgs/inject_dartpad;commands:format-analyze"
+          key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/analysis_defaults-pkgs/excerpter-pkgs/inject_dartpad;commands:format-analyze"
           restore-keys: |
-            os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/excerpter-pkgs/inject_dartpad
+            os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/analysis_defaults-pkgs/excerpter-pkgs/inject_dartpad
             os:ubuntu-latest;pub-cache-hosted;sdk:dev
             os:ubuntu-latest;pub-cache-hosted
             os:ubuntu-latest
@@ -106,6 +119,19 @@ jobs:
       - id: checkout
         name: Checkout repository
         uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938
+      - id: pkgs_analysis_defaults_pub_upgrade
+        name: pkgs/analysis_defaults; dart pub upgrade
+        run: dart pub upgrade
+        if: "always() && steps.checkout.conclusion == 'success'"
+        working-directory: pkgs/analysis_defaults
+      - name: "pkgs/analysis_defaults; dart format --output=none --set-exit-if-changed ."
+        run: "dart format --output=none --set-exit-if-changed ."
+        if: "always() && steps.pkgs_analysis_defaults_pub_upgrade.conclusion == 'success'"
+        working-directory: pkgs/analysis_defaults
+      - name: "pkgs/analysis_defaults; dart analyze --fatal-infos ."
+        run: dart analyze --fatal-infos .
+        if: "always() && steps.pkgs_analysis_defaults_pub_upgrade.conclusion == 'success'"
+        working-directory: pkgs/analysis_defaults
       - id: pkgs_excerpter_pub_upgrade
         name: pkgs/excerpter; dart pub upgrade
         run: dart pub upgrade

.gitignore

@@ -1,12 +1,16 @@
+# Dart-related files
+.dart_tool
+build
+doc/api/
+pubspec.lock
+
+# IDE-related files
 *.iml
 .idea
 .vscode
-.DS_Store
 
-.dart_tool
-build/
-
-build
+# Platform-related files
+.DS_Store
 
 # We want to ignore our StylesPath *except* for our local
 # `vocabularies/Base` directory.

doc/README.md

@@ -0,0 +1,15 @@
+---
+title: Site-shared docs
+description: Site-shared docs
+---
+
+# Site-shared docs
+
+- [Infrastructure](infrastructure.md): shared site infrastructure.
+- [Examples](examples.md): how to organize site example code.
+- [Code excerpts](code-excerpts.md): how to use the code-excerpt feature
+  and its associated tooling.
+- [Markdown](markdown.md) is an _Effective markdown_ guide.
+- [images](images.md) 
+- [mobile friendly pages](mobile-friendly-pages.md)
+- [writing for dart and flutter websites](writing-for-dart-and-flutter-websites.md)

mono_repo.yaml

@@ -1,4 +1,4 @@
-# See https://github.com/google/mono_repo.dart for details on this file
+# Reference https://pub.dev/packages/mono_repo for help with this file.
 self_validate: analyzer_and_format
 
 github:

pkgs/analysis_defaults/analysis_options.yaml

@@ -0,0 +1 @@
+include: package:analysis_defaults/analysis.yaml

pkgs/analysis_defaults/mono_pkg.yaml

@@ -0,0 +1,10 @@
+# Reference https://pub.dev/packages/mono_repo for help with this file.
+sdk:
+  - pubspec
+  - dev
+
+stages:
+  - analyzer_and_format:
+      - group:
+          - format
+          - analyze: --fatal-infos .

pkgs/excerpter/mono_pkg.yaml

@@ -1,4 +1,4 @@
-# See https://github.com/google/mono_repo.dart for details on this file
+# Reference https://pub.dev/packages/mono_repo for help with this file.
 sdk:
 - pubspec
 - dev

pkgs/inject_dartpad/mono_pkg.yaml

@@ -1,4 +1,4 @@
-# See https://github.com/google/mono_repo.dart for details on this file
+# Reference https://pub.dev/packages/mono_repo for help with this file.
 sdk:
   - pubspec
   - dev