Tweak Commit

.github/workflows/build-doctum-docs.yml

@@ -0,0 +1,105 @@
+name: build-doctum-docs
+
+on: [pull_request]
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+
+        name: Update-DoctumDocs-Branch
+
+        steps:
+          - uses: actions/checkout@v3
+
+          - name: build doctum docs
+            uses: sudo-bot/action-doctum@latest
+            with:
+                config-file: doctum-config.php
+                # parse, render or update
+                method: "update"
+                # (optional) defaults to '--output-format=github --no-ansi --no-progress -v'
+                cli-args: "--output-format=github --no-ansi --no-progress -v"
+
+          - name: Remove GitHub Specific Issues
+            run: | 
+              rm .editorconfig
+              rm .gitattributes
+              rm .gitignore
+
+          - name: Remove Package Specific Items
+            run: |
+              rm composer.json
+              rm codecov.yml
+              rm coverage.xml
+              rm doctum-config.php
+              rm phpstan.neon
+              rm phpunit.xml.dist
+              rm psalm.xml.dist
+              rm CHANGELOG.md
+              rm CONTRIBUTORS.md
+              rm LICENSE.md
+              rm README.md
+
+          - name: Remove Package Directories
+            run: | 
+                rm -rf .github
+                rm -rf build/cache
+                rm -rf cache
+                rm -rf config
+                rm -rf docs
+                rm -rf database
+                rm -rf resources
+                rm -rf public
+                rm -rf src
+                rm -rf tests
+                
+          - name: Move Doctum Docs
+            run: |
+                mv build docs
+                git add docs/*
+
+          - name: Restore Readme
+            run: | 
+              echo "This branch is used solely to store Doctum Documents)" >> README.md
+              
+          - uses: stefanzweifel/git-auto-commit-action@v4
+            with:
+                # Optional. Commit message for the created commit.
+                # Defaults to "Apply automatic changes"
+                commit_message: Automated Change
+
+                # Optional. Options used by `git-commit`.
+                # See https://git-scm.com/docs/git-commit#_options
+                commit_options: '--no-verify --signoff'
+
+                # Optional. Option used by `git-status` to determine if the repository is 
+                # dirty. See https://git-scm.com/docs/git-status#_options
+                status_options: '--untracked-files=yes'
+
+                # Optional. Local and remote branch name where commit is going to be pushed
+                #  to. Defaults to the current branch.
+                #  You might need to set `create_branch: true` if the branch does not exist.
+                branch: doctum-docs
+
+                # Optional. Options used by `git-add`.
+                # See https://git-scm.com/docs/git-add#_options
+                add_options: '-u'
+
+                # Optional. Disable dirty check and always try to create a commit and push
+                skip_dirty_check: true 
+
+                # Optional. Skip internal call to `git fetch`
+                skip_fetch: true    
+
+                # Optional. Skip internal call to `git checkout`
+                skip_checkout: true
+
+                # Optional. Options used by `git-push`.
+                # See https://git-scm.com/docs/git-push#_options
+                push_options: '--force'
+
+                # Optional commit user and author settings
+                commit_user_name: Doctum Docs Bot # defaults to "github-actions[bot]"
+                commit_user_email: [email protected] # defaults to "41898282+github-actions[bot]@users.noreply.github.com"
+                commit_author: Doctum Docs Bot <[email protected]> # defaults to author of the commit that triggered the run
+                create_branch: true

doctum-config.php

@@ -14,11 +14,13 @@
     ->exclude('Tests')
     ->in($dir);
 
-// generate documentation for all v2.0.* tags, the 2.0 branch, and the main one
+// generate documentation for all v3.0.* tags, the 2.0 branch, and the 1.0
 $versions = GitVersionCollection::create($dir)
     // In a non case-sensitive way, tags containing "PR", "RC", "BETA" and "ALPHA" will be filtered out
     // To change this, use: `$versions->setFilter(static function (string $version): bool { // ... });`
-    ->add('develop', '3.x branch');
+    ->addFromTags('v3.*')
+    ->addFromTags('v2.*')
+    ->addFromTags('v1.*');
 
 return new Doctum($iterator, [
     'versions' => $versions,