fix: remove unnecessary changes and add missing docs

Author: matiasleyba

.github/workflows/bot_updater.yaml

@@ -45,7 +45,7 @@ jobs:
         uses: peter-evans/create-pull-request@v7.0.8
         with:
           base: main
-          branch: chore/update-spdx-license
+          branch: chore/update-exclusion-table
           commit-message: "docs: update exclusion table"
           title: "docs: update exclusion table"
           body: |
@@ -68,9 +68,9 @@ jobs:
         uses: peter-evans/create-pull-request@v7.0.8
         with:
           base: main
-          branch: chore/remove-deprecated-rules
-          commit-message: "fix: remove deprecated rules"
-          title: "fix: remove deprecated rules"
+          branch: feat/remove-deprecated-rules
+          commit-message: "feat: remove deprecated rules"
+          title: "feat: remove deprecated rules"
           body: |
             There are now rules deprecated that require an update to the Very Good Analysis.
           labels: bot

tool/bump_version/lib/bump_version.dart

@@ -3,7 +3,6 @@
 /// This script will:
 /// - Copy the most recent yaml to a new one with the new desired version.
 /// - Include that file on the main yaml file `lib/analysis_options.yaml.
-/// - Bump the version of the Very Good Analysis package in the pubspec.yaml.
 ///
 /// ## Usage
 ///
@@ -36,9 +35,7 @@ void main(List<String> args) => bumpVersion(args[0]);
 
 /// Bumps the version of the analysis options file and the pubspec.yaml file.
 void bumpVersion(String newVersion, {String basePath = ''}) {
-  final analysisOptionsFile = File(
-    '${basePath}lib/analysis_options.yaml',
-  );
+  final analysisOptionsFile = File('${basePath}lib/analysis_options.yaml');
   final content = analysisOptionsFile.readAsStringSync();
   final latestVersion = _latestAnalysisVersionRegExp
       .firstMatch(content)
@@ -58,15 +55,4 @@ void bumpVersion(String newVersion, {String basePath = ''}) {
     'analysis_options.$newVersion.yaml',
   );
   analysisOptionsFile.writeAsStringSync(newContent);
-
-  final pubspecFile = File(
-    '${basePath}pubspec.yaml',
-  );
-  final pubspecContent = pubspecFile.readAsStringSync();
-  final newPubspecContent = pubspecContent.replaceFirst(
-    'version: $latestVersion',
-    'version: $newVersion',
-  );
-
-  pubspecFile.writeAsStringSync(newPubspecContent);
 }

tool/linter_rules/README.md

@@ -62,3 +62,35 @@ dart bin/analyze.dart $version
 ```
 
 Where version is the existing Very Good Analysis version you would like to analyze, for example `9.0.0`.
+
+
+## Check and remove deprecated rules 🔍
+
+The script `tool/linter_rules/bin/remove_deprecated_rules.dart` helps maintain Very Good Analysis by automatically handling deprecated linter rules.
+
+This script will:
+
+- Fetch the latest rules from the official Dart SDK
+- Identify any deprecated rules currently used in Very Good Analysis
+- Remove deprecated rules from the analysis options file by creating a new minor version of Very Good Analysis without the deprecated rules
+- Assign the new file as the latest version in lib/analysis_options.yaml
+- Add removed rules to the exclusion table with reason 'Deprecated'
+
+### Usage
+
+To check and remove deprecated rules, run the following command (from `tool/linter_rules`):
+
+```sh
+dart bin/remove_deprecated_rules.dart
+```
+
+
+## Automations
+
+There is a [GitHub workflow](../../.github/workflows/bot_updater.yaml) that automates the maintenance of the linter rules. This workflow runs on a schedule (every weekday) and can also be triggered manually.
+
+It performs two main tasks:
+
+1.  **Update Exclusion Table**: It checks if there are any changes to the exclusion reasons for linter rules. If there are, it regenerates the exclusion table in this README and creates a pull request with the title `docs: update exclusion table`.
+
+2.  **Remove Deprecated Rules**: It checks for deprecated linter rules currently used in Very Good Analysis. If any are found, it automatically removes them from the analysis options, creates a new version of the analysis options file, and opens a pull request with the changes, titled `feat: remove deprecated rules`. 

tool/linter_rules/bin/remove_deprecated_rules.dart

@@ -7,9 +7,9 @@ import 'package:yaml_edit/yaml_edit.dart';
 /// Removes deprecated rules from the analysis options file based on the
 /// official Dart linter rules.
 ///
-/// It will create a new version of the analysis options file, bump the version
-/// in the pubspec.yaml, and update the exclusion reasons file and the
-/// table of excluded rules in the README.md file.
+/// It will create a new version of the analysis options file and update the
+/// exclusion reasons file and the table of excluded rules in the README.md
+/// file.
 Future<void> main({
   void Function(String) log = print,
 }) async {