Add Contributing Guide #3
Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
name: build-doctum-docs | |
on: [pull_request] | |
jobs: | |
build: | |
runs-on: ubuntu-latest | |
name: Update-DoctumDocs-Branch | |
steps: | |
- uses: actions/checkout@v3 | |
with: | |
# The branch, tag or SHA to checkout. When checking out the repository that | |
# triggered a workflow, this defaults to the reference or SHA for that event. | |
# Otherwise, uses the default branch. | |
ref: 'develop' | |
- 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: my-github-actions-bot@example.org # defaults to "41898282+github-actions[bot]@users.noreply.github.com" | |
commit_author: Doctum Docs Bot <actions@github.com> # defaults to author of the commit that triggered the run | |
create_branch: true |