diff --git a/.gitea/scoped_workflows/sync-github-metadata.yml b/.gitea/scoped_workflows/sync-github-metadata.yml index 5f0dffe..0f5b4d5 100644 --- a/.gitea/scoped_workflows/sync-github-metadata.yml +++ b/.gitea/scoped_workflows/sync-github-metadata.yml @@ -1,7 +1,7 @@ name: Sync GitHub mirror metadata # Scoped workflow: it runs in every repository of an organization. The script -# is a file of TirSystem/github-action (tools/sync_github_metadata.py), fetched +# is a file of TirSystem/git-workflows (tools/sync_github_metadata.py), fetched # with a checkout so that it is readable, lintable and tested as a file # (MIL-004 task 6). The repository is public, so no token is needed. on: @@ -21,7 +21,7 @@ jobs: - name: Fetch the shared script uses: actions/checkout@v4.2.2 with: - repository: TirSystem/github-action + repository: TirSystem/git-workflows ref: v1 path: shared-scripts diff --git a/.gitea/workflows/code-metrics.yml b/.gitea/workflows/code-metrics.yml index 2a1e195..58361b4 100644 --- a/.gitea/workflows/code-metrics.yml +++ b/.gitea/workflows/code-metrics.yml @@ -7,7 +7,7 @@ name: Code metrics # branches: [main] # jobs: # metrics: -# uses: TirSystem/github-action/.gitea/workflows/code-metrics.yml@v2 +# uses: TirSystem/git-workflows/.gitea/workflows/code-metrics.yml@v2 # permissions: # contents: write # @@ -49,7 +49,7 @@ on: type: string default: "badges" tools-ref: - description: "Tag or branch of TirSystem/github-action whose tools/ files are run; pin it to the exact tag together with the workflow" + description: "Tag or branch of TirSystem/git-workflows whose tools/ files are run; pin it to the exact tag together with the workflow" type: string default: "v2" @@ -74,7 +74,7 @@ jobs: - name: Fetch the shared scripts uses: actions/checkout@v4.2.2 with: - repository: TirSystem/github-action + repository: TirSystem/git-workflows ref: ${{ inputs.tools-ref }} path: shared-scripts diff --git a/.gitea/workflows/english-comments.yml b/.gitea/workflows/english-comments.yml index e0ae657..91be6b6 100644 --- a/.gitea/workflows/english-comments.yml +++ b/.gitea/workflows/english-comments.yml @@ -7,7 +7,7 @@ name: English comments # pull_request: # jobs: # english-comments: -# uses: TirSystem/github-action/.gitea/workflows/english-comments.yml@v2 +# uses: TirSystem/git-workflows/.gitea/workflows/english-comments.yml@v2 # # It reads the comments and docstrings that the pull request adds, judges their # language, fails the run when one is not English and writes one comment on the @@ -46,7 +46,7 @@ on: type: string default: "2.1.3" tools-ref: - description: "Tag or branch of TirSystem/github-action whose tools/english_comments.py is run; pin it to the exact tag together with the workflow" + description: "Tag or branch of TirSystem/git-workflows whose tools/english_comments.py is run; pin it to the exact tag together with the workflow" type: string default: "v2" secrets: @@ -81,7 +81,7 @@ jobs: - name: Fetch the shared scripts uses: actions/checkout@v4.2.2 with: - repository: TirSystem/github-action + repository: TirSystem/git-workflows ref: ${{ inputs.tools-ref }} path: shared-scripts diff --git a/.gitea/workflows/publish-wiki-pages.yml b/.gitea/workflows/publish-wiki-pages.yml index 96ec26b..ea0ba3a 100644 --- a/.gitea/workflows/publish-wiki-pages.yml +++ b/.gitea/workflows/publish-wiki-pages.yml @@ -8,7 +8,7 @@ name: Publish wiki # paths: [ "docs/wiki/**" ] # jobs: # wiki: -# uses: TirSystem/github-action/.gitea/workflows/publish-wiki-pages.yml@v1 +# uses: TirSystem/git-workflows/.gitea/workflows/publish-wiki-pages.yml@v1 # secrets: # TOKEN_FOR_GITEA_WIKI: ${{ secrets.TOKEN_FOR_GITEA_WIKI }} # @@ -29,7 +29,7 @@ on: type: string default: "false" tools-ref: - description: "Tag or branch of TirSystem/github-action whose tools/publish_wiki.py is run; pin it to the exact tag together with the workflow" + description: "Tag or branch of TirSystem/git-workflows whose tools/publish_wiki.py is run; pin it to the exact tag together with the workflow" type: string default: "v2" secrets: @@ -50,7 +50,7 @@ jobs: - name: Fetch the shared script uses: actions/checkout@v4.2.2 with: - repository: TirSystem/github-action + repository: TirSystem/git-workflows ref: ${{ inputs.tools-ref }} path: shared-scripts diff --git a/.gitea/workflows/quality-checks-cpp.yml b/.gitea/workflows/quality-checks-cpp.yml index 8293f3d..1328387 100644 --- a/.gitea/workflows/quality-checks-cpp.yml +++ b/.gitea/workflows/quality-checks-cpp.yml @@ -4,7 +4,7 @@ name: Quality checks C++ # # jobs: # quality: -# uses: TirSystem/github-action/.gitea/workflows/quality-checks-cpp.yml@v1 +# uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-cpp.yml@v1 # # It checks the C and C++ files of the repository with clang-format and # clang-tidy at exact versions, changes no file and needs no secret. The @@ -34,7 +34,7 @@ on: type: string default: "22.1.8" tools-ref: - description: "Tag or branch of TirSystem/github-action whose tools/quality-checks-cpp.sh is run; pin it to the exact tag together with the workflow" + description: "Tag or branch of TirSystem/git-workflows whose tools/quality-checks-cpp.sh is run; pin it to the exact tag together with the workflow" type: string default: "v2" @@ -58,7 +58,7 @@ jobs: - name: Fetch the shared script uses: actions/checkout@v4.2.2 with: - repository: TirSystem/github-action + repository: TirSystem/git-workflows ref: ${{ inputs.tools-ref }} path: shared-scripts diff --git a/.gitea/workflows/quality-checks-csharp.yml b/.gitea/workflows/quality-checks-csharp.yml index 88e273a..dc56641 100644 --- a/.gitea/workflows/quality-checks-csharp.yml +++ b/.gitea/workflows/quality-checks-csharp.yml @@ -4,7 +4,7 @@ name: Quality checks C# # # jobs: # quality: -# uses: TirSystem/github-action/.gitea/workflows/quality-checks-csharp.yml@v1 +# uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-csharp.yml@v1 # # It checks the C# solution or project of the repository with `dotnet format` # and `dotnet build` (warnings as errors) on an exact .NET SDK 10 or later, @@ -25,7 +25,7 @@ on: type: string default: "10.0.401" tools-ref: - description: "Tag or branch of TirSystem/github-action whose tools/quality-checks-csharp.sh is run; pin it to the exact tag together with the workflow" + description: "Tag or branch of TirSystem/git-workflows whose tools/quality-checks-csharp.sh is run; pin it to the exact tag together with the workflow" type: string default: "v2" @@ -47,7 +47,7 @@ jobs: - name: Fetch the shared script uses: actions/checkout@v4.2.2 with: - repository: TirSystem/github-action + repository: TirSystem/git-workflows ref: ${{ inputs.tools-ref }} path: shared-scripts diff --git a/.gitea/workflows/quality-checks.yml b/.gitea/workflows/quality-checks.yml index fa49200..359bcbd 100644 --- a/.gitea/workflows/quality-checks.yml +++ b/.gitea/workflows/quality-checks.yml @@ -4,7 +4,7 @@ name: Quality checks # # jobs: # quality: -# uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v1 +# uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v1 # # It checks the Python and shell files of the repository with pinned tools, # changes no file and needs no secret. @@ -36,7 +36,7 @@ on: type: string default: "3.11.0.2" tools-ref: - description: "Tag or branch of TirSystem/github-action whose tools/quality-checks.sh is run; pin it to the exact tag together with the workflow" + description: "Tag or branch of TirSystem/git-workflows whose tools/quality-checks.sh is run; pin it to the exact tag together with the workflow" type: string default: "v2" @@ -61,7 +61,7 @@ jobs: - name: Fetch the shared script uses: actions/checkout@v4.2.2 with: - repository: TirSystem/github-action + repository: TirSystem/git-workflows ref: ${{ inputs.tools-ref }} path: shared-scripts diff --git a/AGENTS.md b/AGENTS.md index 4ac124c..e7e4bcf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -87,7 +87,7 @@ to be open. | --- | --- | --- | --- | | `TirSystem/SQA-QC-Checklists` | the QC checklists (`qc/artifacts/`, `qc/code/`) | `sqa-qc-framework` | a commit, pinned as the `qc/` submodule | | `TirSystem/sqa-qc-framework` | the skills, process documents, catalog, templates (`templates/ci/`) and scripts | every project, as the `framework/` submodule | a release tag (`v0.5.2`, ...) | -| `TirSystem/github-action` | the shared workflows (`quality-checks`, `release`), the scoped workflows (`publish-wiki`, `sync-github-metadata`) and the scripts they call (`tools/`) | every repository of the organisation, by `uses:` and `ref:` | a release tag and a moving major tag (`v1`), made by its release workflow | +| `TirSystem/git-workflows` | the shared workflows (`quality-checks`, `release`), the scoped workflows (`publish-wiki`, `sync-github-metadata`) and the scripts they call (`tools/`) | every repository of the organisation, by `uses:` and `ref:` | a release tag and a moving major tag (`v1`), made by its release workflow | | `TirSystem/sqa-and-qc` | the SQA and AI project management: project artifacts, review records, the traceability matrix | itself | the pull request that merges it | Where a thing lives: @@ -96,10 +96,10 @@ Where a thing lives: reaches this project by moving the pin. The review record of a checklist is written in the project that reviews it (`docs/sqa/reviews/`), not in the checklist repository. -- A workflow that other repositories call is changed in `github-action` and +- A workflow that other repositories call is changed in `git-workflows` and released there. A workflow a project copies from `templates/ci/` is changed in the framework; the project updates its copy after the pin moves. -- A script a workflow needs is a file (`tools/` of `github-action`, or +- A script a workflow needs is a file (`tools/` of `git-workflows`, or `scripts/` of the framework for the templates), never a long `run:` block (`QC-WF-001` criterion 20). - The workflows under `.gitea/workflows/` are this project's own copies of @@ -108,7 +108,7 @@ Where a thing lives: A change that spans repositories: 1. One pull request per repository, in dependency order: checklists, then - framework, then `github-action` and the projects. A pull request names the + framework, then `git-workflows` and the projects. A pull request names the ones it depends on in its description. 2. A downstream repository moves a pin only to a merged commit or tag of the upstream, never to an unmerged branch. diff --git a/README.md b/README.md index 97ca937..47f6932 100644 --- a/README.md +++ b/README.md @@ -107,7 +107,7 @@ deactivate Workflow ### ✅ Quality checks -A reusable workflow for Python and shell, called with `uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v1` (see the [guide](guides/quality-checks.md)). +A reusable workflow for Python and shell, called with `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v1` (see the [guide](guides/quality-checks.md)). #### 🔀 Workflow @@ -153,7 +153,7 @@ deactivate Workflow ### 🧱 Quality checks C++ -A reusable workflow for C and C++, called with `uses: TirSystem/github-action/.gitea/workflows/quality-checks-cpp.yml@v1` (ADR-0008). The repository needs a `.clang-format`; a `.clang-tidy` and a compile database are optional. +A reusable workflow for C and C++, called with `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-cpp.yml@v1` (ADR-0008). The repository needs a `.clang-format`; a `.clang-tidy` and a compile database are optional. #### 🔀 Workflow @@ -198,7 +198,7 @@ deactivate Workflow ### 🟣 Quality checks C# -A reusable workflow for C#, called with `uses: TirSystem/github-action/.gitea/workflows/quality-checks-csharp.yml@v1` (ADR-0008). It installs the exact .NET SDK given by `dotnet-sdk-version` (10 or later) and needs the network for the package restore. +A reusable workflow for C#, called with `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-csharp.yml@v1` (ADR-0008). It installs the exact .NET SDK given by `dotnet-sdk-version` (10 or later) and needs the network for the package restore. #### 🔀 Workflow @@ -243,7 +243,7 @@ deactivate Workflow ### 🏅 Code metrics -A reusable workflow that counts the code files and the lines of code (without comment and blank lines) of a repository and publishes them, with the test coverage, as three SVG badges on a `badges` branch, called with `uses: TirSystem/github-action/.gitea/workflows/code-metrics.yml@v2` (ADR-0010). It needs `contents: write` and runs no test: an earlier job of the caller produces a Cobertura XML coverage report and uploads it as an artifact ([guide](guides/code-metrics.md)). +A reusable workflow that counts the code files and the lines of code (without comment and blank lines) of a repository and publishes them, with the test coverage, as three SVG badges on a `badges` branch, called with `uses: TirSystem/git-workflows/.gitea/workflows/code-metrics.yml@v2` (ADR-0010). It needs `contents: write` and runs no test: an earlier job of the caller produces a Cobertura XML coverage report and uploads it as an artifact ([guide](guides/code-metrics.md)). #### 🔀 Workflow @@ -385,7 +385,7 @@ on: paths: [ "docs/wiki/**" ] jobs: wiki: - uses: TirSystem/github-action/.gitea/workflows/publish-wiki-pages.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/publish-wiki-pages.yml@v1 secrets: TOKEN_FOR_GITEA_WIKI: ${{ secrets.TOKEN_FOR_GITEA_WIKI }} ``` @@ -551,7 +551,7 @@ No dependencies need to be installed; the workflow uses only the Python standard 1. Clone the repository: ```bash - git clone ssh://git@git.tirsystem.com:10022/TirSystem/github-action.git + git clone ssh://git@git.tirsystem.com:10022/TirSystem/git-workflows.git ``` 2. Add the secrets listed under [Requirements](#-requirements) to the repository settings in Gitea. 3. Configure the GitHub push mirror in the repository settings. @@ -598,6 +598,6 @@ Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See [LICEN ## 🔗 Links -- [Repository](https://git.tirsystem.com/TirSystem/github-action) -- [Documentation](https://git.tirsystem.com/TirSystem/github-action#readme) -- [Issue tracker](https://git.tirsystem.com/TirSystem/github-action/issues) +- [Repository](https://git.tirsystem.com/TirSystem/git-workflows) +- [Documentation](https://git.tirsystem.com/TirSystem/git-workflows#readme) +- [Issue tracker](https://git.tirsystem.com/TirSystem/git-workflows/issues) diff --git a/docs/wiki/Capabilities.da.md b/docs/wiki/Capabilities.da.md index 1971af1..aec2be0 100644 --- a/docs/wiki/Capabilities.da.md +++ b/docs/wiki/Capabilities.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`Capabilities`](Capabilities). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -6,7 +6,7 @@ ## Funktionalitet -Rækker, der siger Implementeret eller Vejledninger er skrevet, findes i dag. Resten er planlagt og følges i [projektplanen](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/docs/project-plan.md), som også beskriver hver enkelt use case. +Rækker, der siger Implementeret eller Vejledninger er skrevet, findes i dag. Resten er planlagt og følges i [projektplanen](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/docs/project-plan.md), som også beskriver hver enkelt use case. | Funktionalitet | Status | | --- | --- | diff --git a/docs/wiki/Capabilities.md b/docs/wiki/Capabilities.md index 1495fec..efa80e9 100644 --- a/docs/wiki/Capabilities.md +++ b/docs/wiki/Capabilities.md @@ -1,12 +1,12 @@ -> This page is generated from [`README.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/README.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`README.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/README.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](Capabilities.da) | [Bahasa Melayu](Capabilities.ms) ## Capabilities -Rows that say Implemented or Guides written exist today. The rest is planned and tracked in the [Project Plan](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/docs/project-plan.md), which also describes each use case. +Rows that say Implemented or Guides written exist today. The rest is planned and tracked in the [Project Plan](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/docs/project-plan.md), which also describes each use case. | Capability | Status | | --- | --- | diff --git a/docs/wiki/Capabilities.ms.md b/docs/wiki/Capabilities.ms.md index 96d621b..7b6e6c9 100644 --- a/docs/wiki/Capabilities.ms.md +++ b/docs/wiki/Capabilities.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`Capabilities`](Capabilities). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. @@ -6,7 +6,7 @@ ## Keupayaan -Baris yang menyatakan Dilaksanakan atau Panduan telah ditulis wujud hari ini. Selebihnya dirancang dan dijejaki dalam [Pelan Projek](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/docs/project-plan.md), yang juga menerangkan setiap kes guna (use case). +Baris yang menyatakan Dilaksanakan atau Panduan telah ditulis wujud hari ini. Selebihnya dirancang dan dijejaki dalam [Pelan Projek](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/docs/project-plan.md), yang juga menerangkan setiap kes guna (use case). | Keupayaan | Status | | --- | --- | diff --git a/docs/wiki/CodeMetrics.da.md b/docs/wiki/CodeMetrics.da.md index 008ac6a..87e3112 100644 --- a/docs/wiki/CodeMetrics.da.md +++ b/docs/wiki/CodeMetrics.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`CodeMetrics`](CodeMetrics). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -34,7 +34,7 @@ jobs: needs: tests permissions: contents: write - uses: TirSystem/github-action/.gitea/workflows/code-metrics.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/code-metrics.yml@v2 with: coverage-artifact: coverage coverage-report: coverage.xml @@ -49,7 +49,7 @@ jobs: | `coverage-warn` | `60` | Dækning i procent, under hvilken badget er rødt | | `coverage-good` | `80` | Dækning i procent, fra hvilken badget er grønt; derimellem er det gult | | `badges-branch` | `badges` | Gren, der indeholder badge-filerne; den oprettes, hvis den ikke findes | -| `tools-ref` | `v2` | Tag eller gren i `TirSystem/github-action`, hvorfra scripts i `tools/` hentes | +| `tools-ref` | `v2` | Tag eller gren i `TirSystem/git-workflows`, hvorfra scripts i `tools/` hentes | Reference workflowet ved major-tagget (`@v1`) eller ved et præcist tag, aldrig ved `main`. Et kald ved et præcist tag er kun fuldt fastlåst, når `tools-ref` navngiver samme tag. Se opgraderingsvejledningen. Start workflowet kun ved push til din standardgren: badge-committet har `[skip ci]` og laves med kørslens token, som ikke starter en ny kørsel, men en trigger på alle grene ville skrive ét commit pr. gren. diff --git a/docs/wiki/CodeMetrics.md b/docs/wiki/CodeMetrics.md index 7edb426..db218ed 100644 --- a/docs/wiki/CodeMetrics.md +++ b/docs/wiki/CodeMetrics.md @@ -1,6 +1,6 @@ -> This page is generated from [`guides/code-metrics.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/code-metrics.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`guides/code-metrics.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/code-metrics.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](CodeMetrics.da) | [Bahasa Melayu](CodeMetrics.ms) @@ -40,7 +40,7 @@ jobs: needs: tests permissions: contents: write - uses: TirSystem/github-action/.gitea/workflows/code-metrics.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/code-metrics.yml@v2 with: coverage-artifact: coverage coverage-report: coverage.xml @@ -55,7 +55,7 @@ jobs: | `coverage-warn` | `60` | Coverage in percent below which the badge is red | | `coverage-good` | `80` | Coverage in percent from which the badge is green; in between it is yellow | | `badges-branch` | `badges` | Branch that holds the badge files; it is created when it does not exist | -| `tools-ref` | `v2` | Tag or branch of `TirSystem/github-action` from which the scripts in `tools/` are fetched | +| `tools-ref` | `v2` | Tag or branch of `TirSystem/git-workflows` from which the scripts in `tools/` are fetched | Reference the workflow at the major tag (`@v2`) or at an exact tag, never at `main`. A call at an exact tag is pinned completely only when `tools-ref` names diff --git a/docs/wiki/CodeMetrics.ms.md b/docs/wiki/CodeMetrics.ms.md index bc67a5c..a87f4fc 100644 --- a/docs/wiki/CodeMetrics.ms.md +++ b/docs/wiki/CodeMetrics.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`CodeMetrics`](CodeMetrics). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. @@ -34,7 +34,7 @@ jobs: needs: tests permissions: contents: write - uses: TirSystem/github-action/.gitea/workflows/code-metrics.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/code-metrics.yml@v2 with: coverage-artifact: coverage coverage-report: coverage.xml @@ -49,7 +49,7 @@ jobs: | `coverage-warn` | `60` | Liputan dalam peratus di bawahnya lencana berwarna merah | | `coverage-good` | `80` | Liputan dalam peratus yang bermulanya lencana berwarna hijau; di antaranya kuning | | `badges-branch` | `badges` | Cabang yang memegang fail lencana; ia dicipta jika tidak wujud | -| `tools-ref` | `v2` | Tag atau cabang `TirSystem/github-action` tempat skrip dalam `tools/` diambil | +| `tools-ref` | `v2` | Tag atau cabang `TirSystem/git-workflows` tempat skrip dalam `tools/` diambil | Rujuk aliran kerja pada tag major (`@v1`) atau pada tag tepat, jangan sekali-kali pada `main`. Panggilan pada tag tepat hanya tersemat sepenuhnya apabila `tools-ref` menamakan tag yang sama. Lihat panduan menaik taraf. Mulakan aliran kerja pada push ke cabang lalai anda sahaja: commit lencana membawa `[skip ci]` dan dibuat dengan token larian, yang tidak memulakan larian lain, tetapi pencetus pada setiap cabang akan menulis satu commit bagi setiap cabang. diff --git a/docs/wiki/Credentials.da.md b/docs/wiki/Credentials.da.md index 683ee83..a7cd04d 100644 --- a/docs/wiki/Credentials.da.md +++ b/docs/wiki/Credentials.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`Credentials`](Credentials). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. diff --git a/docs/wiki/Credentials.md b/docs/wiki/Credentials.md index bf02e2a..10fc5de 100644 --- a/docs/wiki/Credentials.md +++ b/docs/wiki/Credentials.md @@ -1,6 +1,6 @@ -> This page is generated from [`guides/credentials.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/credentials.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`guides/credentials.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/credentials.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](Credentials.da) | [Bahasa Melayu](Credentials.ms) diff --git a/docs/wiki/Credentials.ms.md b/docs/wiki/Credentials.ms.md index f63b52e..f15be03 100644 --- a/docs/wiki/Credentials.ms.md +++ b/docs/wiki/Credentials.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`Credentials`](Credentials). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. diff --git a/docs/wiki/EnglishComments.da.md b/docs/wiki/EnglishComments.da.md index e263cf3..e0cfa17 100644 --- a/docs/wiki/EnglishComments.da.md +++ b/docs/wiki/EnglishComments.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`EnglishComments`](EnglishComments). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -22,7 +22,7 @@ on: jobs: english-comments: - uses: TirSystem/github-action/.gitea/workflows/english-comments.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/english-comments.yml@v2 with: exclude: "docs/generated/**" allowed-words-file: .english-comments-allowed-words diff --git a/docs/wiki/EnglishComments.md b/docs/wiki/EnglishComments.md index 25b14a0..433dd23 100644 --- a/docs/wiki/EnglishComments.md +++ b/docs/wiki/EnglishComments.md @@ -1,6 +1,6 @@ -> This page is generated from [`guides/english-comments.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/english-comments.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`guides/english-comments.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/english-comments.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](EnglishComments.da) | [Bahasa Melayu](EnglishComments.ms) @@ -22,7 +22,7 @@ on: jobs: english-comments: - uses: TirSystem/github-action/.gitea/workflows/english-comments.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/english-comments.yml@v2 with: exclude: "docs/generated/**" allowed-words-file: .english-comments-allowed-words diff --git a/docs/wiki/EnglishComments.ms.md b/docs/wiki/EnglishComments.ms.md index 94bab37..513571d 100644 --- a/docs/wiki/EnglishComments.ms.md +++ b/docs/wiki/EnglishComments.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`EnglishComments`](EnglishComments). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. @@ -23,7 +23,7 @@ on: jobs: english-comments: - uses: TirSystem/github-action/.gitea/workflows/english-comments.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/english-comments.yml@v2 with: exclude: "docs/generated/**" allowed-words-file: .english-comments-allowed-words diff --git a/docs/wiki/Home.da.md b/docs/wiki/Home.da.md index 0c6923c..f3cbcde 100644 --- a/docs/wiki/Home.da.md +++ b/docs/wiki/Home.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`Home`](Home). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -22,17 +22,17 @@ Der er elleve workflows i dette repository. Et **scoped** workflow leveres af in | Workflow | Fil | Type | Starter ved | Formål | | --- | --- | --- | --- | --- | -| Sync GitHub mirror metadata | [`sync-github-metadata.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/scoped_workflows/sync-github-metadata.yml) | Scoped | push til `main`, manuelt, dagligt kl. 03:17 UTC | Kopierer beskrivelsen og emnerne for et Gitea-repository til dets GitHub push-spejl | -| Publish wiki pages | [`publish-wiki-pages.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/publish-wiki-pages.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Publicerer siderne i `docs/wiki/` (eller den mappe, `wiki_dir` angiver) til wikien i det kaldende repository | -| Quality checks | [`quality-checks.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/quality-checks.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Kører ruff, mypy, shellcheck og shfmt på de sporede filer og ændrer intet | -| Quality checks C++ | [`quality-checks-cpp.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/quality-checks-cpp.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Kører clang-format og clang-tidy i præcise versioner på de sporede C- og C++-filer og ændrer intet | -| Quality checks C# | [`quality-checks-csharp.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/quality-checks-csharp.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Kører `dotnet format` og `dotnet build` på et præcist .NET SDK 10 eller nyere og ændrer intet | -| Code metrics | [`code-metrics.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/code-metrics.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Tæller kodefilerne og kodelinjerne (uden kommentar- og tomme linjer), læser en Cobertura-dækningsrapport og committer tre SVG-badges til en `badges`-gren | -| English comments | [`english-comments.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/english-comments.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository, på en pull request | Bedømmer sproget i de kommentarer og docstrings, en pull request tilføjer, lader kørslen fejle, når én ikke er engelsk, og skriver én kommentar på pull requesten, der nævner forfatteren | -| Publish own wiki | [`publish-own-wiki.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/publish-own-wiki.yml) | Kun dette repository | push til `main`, der ændrer `docs/wiki/**`, manuelt | Kalder det genbrugelige workflow Publish wiki pages for dette repositorys wiki | -| Release | [`release.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/release.yml) | Kun dette repository | manuelt | Opretter versionstagget, udgivelsessiden og major-tagget efter kontrollerne | -| Publicering af accepterede milepæle | [`sync-milestones.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/sync-milestones.yml) | Kun dette repository | push til `main`, der ændrer `docs/milestones/**` eller `docs/sqa/reviews/**`, manuelt (tørkørsel som standard) | Opretter eller opdaterer Gitea-milepælen og issues for hver milepæl, der er Accepted med en Go-gennemgang | -| Validate workflows | [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/validate-workflows.yml) | Kun dette repository | pull request, push til `main`, manuelt | Læser hvert workflow som YAML og kører offline-testene | +| Sync GitHub mirror metadata | [`sync-github-metadata.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/scoped_workflows/sync-github-metadata.yml) | Scoped | push til `main`, manuelt, dagligt kl. 03:17 UTC | Kopierer beskrivelsen og emnerne for et Gitea-repository til dets GitHub push-spejl | +| Publish wiki pages | [`publish-wiki-pages.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/publish-wiki-pages.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Publicerer siderne i `docs/wiki/` (eller den mappe, `wiki_dir` angiver) til wikien i det kaldende repository | +| Quality checks | [`quality-checks.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/quality-checks.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Kører ruff, mypy, shellcheck og shfmt på de sporede filer og ændrer intet | +| Quality checks C++ | [`quality-checks-cpp.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/quality-checks-cpp.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Kører clang-format og clang-tidy i præcise versioner på de sporede C- og C++-filer og ændrer intet | +| Quality checks C# | [`quality-checks-csharp.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/quality-checks-csharp.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Kører `dotnet format` og `dotnet build` på et præcist .NET SDK 10 eller nyere og ændrer intet | +| Code metrics | [`code-metrics.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/code-metrics.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository | Tæller kodefilerne og kodelinjerne (uden kommentar- og tomme linjer), læser en Cobertura-dækningsrapport og committer tre SVG-badges til en `badges`-gren | +| English comments | [`english-comments.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/english-comments.yml) | Genbrugeligt (`workflow_call`) | et kald fra et andet repository, på en pull request | Bedømmer sproget i de kommentarer og docstrings, en pull request tilføjer, lader kørslen fejle, når én ikke er engelsk, og skriver én kommentar på pull requesten, der nævner forfatteren | +| Publish own wiki | [`publish-own-wiki.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/publish-own-wiki.yml) | Kun dette repository | push til `main`, der ændrer `docs/wiki/**`, manuelt | Kalder det genbrugelige workflow Publish wiki pages for dette repositorys wiki | +| Release | [`release.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/release.yml) | Kun dette repository | manuelt | Opretter versionstagget, udgivelsessiden og major-tagget efter kontrollerne | +| Publicering af accepterede milepæle | [`sync-milestones.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/sync-milestones.yml) | Kun dette repository | push til `main`, der ændrer `docs/milestones/**` eller `docs/sqa/reviews/**`, manuelt (tørkørsel som standard) | Opretter eller opdaterer Gitea-milepælen og issues for hver milepæl, der er Accepted med en Go-gennemgang | +| Validate workflows | [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/validate-workflows.yml) | Kun dette repository | pull request, push til `main`, manuelt | Læser hvert workflow som YAML og kører offline-testene | ### Synkronisering af GitHub-metadata @@ -102,7 +102,7 @@ deactivate Workflow ### Kvalitetskontrol -Et genbrugeligt workflow til Python og shell, kaldt med `uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v1` (se [vejledningen](QualityChecksPythonShell)). +Et genbrugeligt workflow til Python og shell, kaldt med `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v1` (se [vejledningen](QualityChecksPythonShell)). #### Workflow @@ -148,7 +148,7 @@ deactivate Workflow ### Kvalitetskontrol C++ -Et genbrugeligt workflow til C og C++, kaldt med `uses: TirSystem/github-action/.gitea/workflows/quality-checks-cpp.yml@v1` (ADR-0008). Repositoryet skal have en `.clang-format`; en `.clang-tidy` og en compile-database er valgfrie. +Et genbrugeligt workflow til C og C++, kaldt med `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-cpp.yml@v1` (ADR-0008). Repositoryet skal have en `.clang-format`; en `.clang-tidy` og en compile-database er valgfrie. #### Workflow @@ -193,7 +193,7 @@ deactivate Workflow ### Kvalitetskontrol C# -Et genbrugeligt workflow til C#, kaldt med `uses: TirSystem/github-action/.gitea/workflows/quality-checks-csharp.yml@v1` (ADR-0008). Det installerer det præcise .NET SDK, som `dotnet-sdk-version` angiver (10 eller nyere), og skal bruge netværket til pakkegendannelsen. +Et genbrugeligt workflow til C#, kaldt med `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-csharp.yml@v1` (ADR-0008). Det installerer det præcise .NET SDK, som `dotnet-sdk-version` angiver (10 eller nyere), og skal bruge netværket til pakkegendannelsen. #### Workflow @@ -238,7 +238,7 @@ deactivate Workflow ### Kodemålinger og dækningsbadges -Et genbrugeligt workflow, der tæller kodefilerne og kodelinjerne (uden kommentar- og tomme linjer) i et repository og udgiver dem sammen med testdækningen som tre SVG-badges på en `badges`-gren, kaldt med `uses: TirSystem/github-action/.gitea/workflows/code-metrics.yml@v2` (ADR-0010). Det kræver `contents: write` og kører ingen test: et tidligere job hos kalderen frembringer en dækningsrapport i Cobertura XML-format og uploader den som artefakt ([vejledning](CodeMetrics.da)). +Et genbrugeligt workflow, der tæller kodefilerne og kodelinjerne (uden kommentar- og tomme linjer) i et repository og udgiver dem sammen med testdækningen som tre SVG-badges på en `badges`-gren, kaldt med `uses: TirSystem/git-workflows/.gitea/workflows/code-metrics.yml@v2` (ADR-0010). Det kræver `contents: write` og kører ingen test: et tidligere job hos kalderen frembringer en dækningsrapport i Cobertura XML-format og uploader den som artefakt ([vejledning](CodeMetrics.da)). #### Workflow @@ -322,7 +322,7 @@ deactivate Workflow ### Udgivelse -Startes manuelt af en vedligeholder; med `dry_run` `true` (standard) kontrollerer det kun (se [udgivelsesprocessen](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/release-process.md)). +Startes manuelt af en vedligeholder; med `dry_run` `true` (standard) kontrollerer det kun (se [udgivelsesprocessen](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/release-process.md)). #### Workflow @@ -380,7 +380,7 @@ on: paths: [ "docs/wiki/**" ] jobs: wiki: - uses: TirSystem/github-action/.gitea/workflows/publish-wiki-pages.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/publish-wiki-pages.yml@v1 secrets: TOKEN_FOR_GITEA_WIKI: ${{ secrets.TOKEN_FOR_GITEA_WIKI }} ``` @@ -548,7 +548,7 @@ Der skal ikke installeres afhængigheder; workflowet bruger kun Pythons standard 1. Klon repositoryet: ```bash - git clone ssh://git@git.tirsystem.com:10022/TirSystem/github-action.git + git clone ssh://git@git.tirsystem.com:10022/TirSystem/git-workflows.git ``` 2. Tilføj de secrets, der er nævnt under [Krav](#krav), til repositoryets indstillinger i Gitea. 3. Konfigurer GitHub push-spejlet i repositoryets indstillinger. @@ -571,6 +571,6 @@ python -m coverage run -m pytest -q tests python -m coverage report ``` -De samme kontroller kører ved hver pull request og hvert push til `main` gennem [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/validate-workflows.yml). De parser alle workflows som YAML, kontrollerer at ingen indlejrer Python, kompilerer scripts i `tools/`, kræver eksplicitte jobtilladelser og tester parsing af credentials, parsing af push-spejlets adresse og synkroniserings- og publiceringsforløbene mod et falsk API. Kørslen fejler, når linje- og forgreningsdækningen af `tools/` er under 95 % (`.coveragerc`). +De samme kontroller kører ved hver pull request og hvert push til `main` gennem [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/validate-workflows.yml). De parser alle workflows som YAML, kontrollerer at ingen indlejrer Python, kompilerer scripts i `tools/`, kræver eksplicitte jobtilladelser og tester parsing af credentials, parsing af push-spejlets adresse og synkroniserings- og publiceringsforløbene mod et falsk API. Kørslen fejler, når linje- og forgreningsdækningen af `tools/` er under 95 % (`.coveragerc`). Efter en ændring af synkroniseringsworkflowet skal du også starte **Sync GitHub mirror metadata** manuelt i Gitea og sammenligne beskrivelsen og emnerne på GitHub-spejlet. diff --git a/docs/wiki/Home.md b/docs/wiki/Home.md index 16114a3..ec478b9 100644 --- a/docs/wiki/Home.md +++ b/docs/wiki/Home.md @@ -1,6 +1,6 @@ -> This page is generated from [`README.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/README.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`README.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/README.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](Home.da) | [Bahasa Melayu](Home.ms) @@ -18,21 +18,23 @@ It contains eleven workflows: metadata sync to the GitHub mirror, wiki publishin ## Workflows +When a repository should use each workflow in its SQA and QC is set out in the [adoption rules](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/adoption-rules.md). + Eleven workflows live in this repository. A **scoped** workflow is delivered by the instance to every repository of the TirSystem organizations and needs nothing in the repository; a **reusable** workflow is called by a repository with `uses:`; the others run only here. The diagrams are PlantUML source. | Workflow | File | Kind | Starts on | Purpose | | --- | --- | --- | --- | --- | -| Sync GitHub mirror metadata | [`sync-github-metadata.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/scoped_workflows/sync-github-metadata.yml) | Scoped | push to `main`, manual, daily 03:17 UTC | Copies the description and topics of a Gitea repository to its GitHub push mirror | -| Publish wiki pages | [`publish-wiki-pages.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/publish-wiki-pages.yml) | Reusable (`workflow_call`) | a call from another repository | Publishes the pages in `docs/wiki/` (or the folder named by `wiki_dir`) to the wiki of the calling repository | -| Quality checks | [`quality-checks.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/quality-checks.yml) | Reusable (`workflow_call`) | a call from another repository | Runs ruff, mypy, shellcheck and shfmt on the tracked files and changes nothing | -| Quality checks C++ | [`quality-checks-cpp.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/quality-checks-cpp.yml) | Reusable (`workflow_call`) | a call from another repository | Runs clang-format and clang-tidy at exact versions on the tracked C and C++ files and changes nothing | -| Quality checks C# | [`quality-checks-csharp.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/quality-checks-csharp.yml) | Reusable (`workflow_call`) | a call from another repository | Runs `dotnet format` and `dotnet build` on an exact .NET SDK 10 or later and changes nothing | -| Code metrics | [`code-metrics.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/code-metrics.yml) | Reusable (`workflow_call`) | a call from another repository | Counts the code files and the lines of code (without comment and blank lines), reads a Cobertura coverage report and commits three SVG badges to a `badges` branch | -| English comments | [`english-comments.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/english-comments.yml) | Reusable (`workflow_call`) | a call from another repository, on a pull request | Judges the language of the comments and docstrings a pull request adds, fails the run when one is not English and writes one comment on the pull request that mentions the author | -| Publish own wiki | [`publish-own-wiki.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/publish-own-wiki.yml) | This repository only | push to `main` that changes `docs/wiki/**`, manual | Calls the reusable Publish wiki pages workflow for the wiki of this repository | -| Release | [`release.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/release.yml) | This repository only | manual | Creates the version tag, the release page and the major tag after the checks | -| Publish accepted milestones | [`sync-milestones.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/sync-milestones.yml) | This repository only | push to `main` that changes `docs/milestones/**` or `docs/sqa/reviews/**`, manual (dry run by default) | Creates or updates the Gitea milestone and issues of every milestone that is Accepted with a Go review | -| Validate workflows | [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/validate-workflows.yml) | This repository only | pull request, push to `main`, manual | Parses every workflow and runs the offline tests | +| Sync GitHub mirror metadata | [`sync-github-metadata.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/scoped_workflows/sync-github-metadata.yml) | Scoped | push to `main`, manual, daily 03:17 UTC | Copies the description and topics of a Gitea repository to its GitHub push mirror | +| Publish wiki pages | [`publish-wiki-pages.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/publish-wiki-pages.yml) | Reusable (`workflow_call`) | a call from another repository | Publishes the pages in `docs/wiki/` (or the folder named by `wiki_dir`) to the wiki of the calling repository | +| Quality checks | [`quality-checks.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/quality-checks.yml) | Reusable (`workflow_call`) | a call from another repository | Runs ruff, mypy, shellcheck and shfmt on the tracked files and changes nothing | +| Quality checks C++ | [`quality-checks-cpp.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/quality-checks-cpp.yml) | Reusable (`workflow_call`) | a call from another repository | Runs clang-format and clang-tidy at exact versions on the tracked C and C++ files and changes nothing | +| Quality checks C# | [`quality-checks-csharp.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/quality-checks-csharp.yml) | Reusable (`workflow_call`) | a call from another repository | Runs `dotnet format` and `dotnet build` on an exact .NET SDK 10 or later and changes nothing | +| Code metrics | [`code-metrics.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/code-metrics.yml) | Reusable (`workflow_call`) | a call from another repository | Counts the code files and the lines of code (without comment and blank lines), reads a Cobertura coverage report and commits three SVG badges to a `badges` branch | +| English comments | [`english-comments.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/english-comments.yml) | Reusable (`workflow_call`) | a call from another repository, on a pull request | Judges the language of the comments and docstrings a pull request adds, fails the run when one is not English and writes one comment on the pull request that mentions the author | +| Publish own wiki | [`publish-own-wiki.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/publish-own-wiki.yml) | This repository only | push to `main` that changes `docs/wiki/**`, manual | Calls the reusable Publish wiki pages workflow for the wiki of this repository | +| Release | [`release.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/release.yml) | This repository only | manual | Creates the version tag, the release page and the major tag after the checks | +| Publish accepted milestones | [`sync-milestones.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/sync-milestones.yml) | This repository only | push to `main` that changes `docs/milestones/**` or `docs/sqa/reviews/**`, manual (dry run by default) | Creates or updates the Gitea milestone and issues of every milestone that is Accepted with a Go review | +| Validate workflows | [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/validate-workflows.yml) | This repository only | pull request, push to `main`, manual | Parses every workflow and runs the offline tests | ### Sync GitHub metadata @@ -102,7 +104,7 @@ deactivate Workflow ### Quality checks -A reusable workflow for Python and shell, called with `uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v1` (see the [guide](QualityChecksPythonShell)). +A reusable workflow for Python and shell, called with `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v1` (see the [guide](QualityChecksPythonShell)). #### Workflow @@ -148,7 +150,7 @@ deactivate Workflow ### Quality checks C++ -A reusable workflow for C and C++, called with `uses: TirSystem/github-action/.gitea/workflows/quality-checks-cpp.yml@v1` (ADR-0008). The repository needs a `.clang-format`; a `.clang-tidy` and a compile database are optional. +A reusable workflow for C and C++, called with `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-cpp.yml@v1` (ADR-0008). The repository needs a `.clang-format`; a `.clang-tidy` and a compile database are optional. #### Workflow @@ -193,7 +195,7 @@ deactivate Workflow ### Quality checks C# -A reusable workflow for C#, called with `uses: TirSystem/github-action/.gitea/workflows/quality-checks-csharp.yml@v1` (ADR-0008). It installs the exact .NET SDK given by `dotnet-sdk-version` (10 or later) and needs the network for the package restore. +A reusable workflow for C#, called with `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-csharp.yml@v1` (ADR-0008). It installs the exact .NET SDK given by `dotnet-sdk-version` (10 or later) and needs the network for the package restore. #### Workflow @@ -238,7 +240,7 @@ deactivate Workflow ### Code metrics -A reusable workflow that counts the code files and the lines of code (without comment and blank lines) of a repository and publishes them, with the test coverage, as three SVG badges on a `badges` branch, called with `uses: TirSystem/github-action/.gitea/workflows/code-metrics.yml@v2` (ADR-0010). It needs `contents: write` and runs no test: an earlier job of the caller produces a Cobertura XML coverage report and uploads it as an artifact ([guide](CodeMetrics)). +A reusable workflow that counts the code files and the lines of code (without comment and blank lines) of a repository and publishes them, with the test coverage, as three SVG badges on a `badges` branch, called with `uses: TirSystem/git-workflows/.gitea/workflows/code-metrics.yml@v2` (ADR-0010). It needs `contents: write` and runs no test: an earlier job of the caller produces a Cobertura XML coverage report and uploads it as an artifact ([guide](CodeMetrics)). #### Workflow @@ -322,7 +324,7 @@ deactivate Workflow ### Release -Started by hand by a maintainer; with `dry_run` `true` (the default) it only checks (see the [release process](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/release-process.md)). +Started by hand by a maintainer; with `dry_run` `true` (the default) it only checks (see the [release process](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/release-process.md)). #### Workflow @@ -380,7 +382,7 @@ on: paths: [ "docs/wiki/**" ] jobs: wiki: - uses: TirSystem/github-action/.gitea/workflows/publish-wiki-pages.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/publish-wiki-pages.yml@v1 secrets: TOKEN_FOR_GITEA_WIKI: ${{ secrets.TOKEN_FOR_GITEA_WIKI }} ``` @@ -548,7 +550,7 @@ No dependencies need to be installed; the workflow uses only the Python standard 1. Clone the repository: ```bash - git clone ssh://git@git.tirsystem.com:10022/TirSystem/github-action.git + git clone ssh://git@git.tirsystem.com:10022/TirSystem/git-workflows.git ``` 2. Add the secrets listed under [Requirements](#requirements) to the repository settings in Gitea. 3. Configure the GitHub push mirror in the repository settings. @@ -571,6 +573,6 @@ python -m coverage run -m pytest -q tests python -m coverage report ``` -The same checks run on every pull request and push to `main` through [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/validate-workflows.yml). They parse every workflow as YAML, check that none embeds Python, compile the scripts in `tools/`, require explicit job permissions, and test credential parsing, push mirror address parsing and the sync and publish flows against a fake API. The run fails when the line and branch coverage of `tools/` falls below 95% (`.coveragerc`). +The same checks run on every pull request and push to `main` through [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/validate-workflows.yml). They parse every workflow as YAML, check that none embeds Python, compile the scripts in `tools/`, require explicit job permissions, and test credential parsing, push mirror address parsing and the sync and publish flows against a fake API. The run fails when the line and branch coverage of `tools/` falls below 95% (`.coveragerc`). After a change to the sync workflow, also trigger **Sync GitHub mirror metadata** manually in Gitea and compare the description and topics on the GitHub mirror. diff --git a/docs/wiki/Home.ms.md b/docs/wiki/Home.ms.md index 98802d9..1823f28 100644 --- a/docs/wiki/Home.ms.md +++ b/docs/wiki/Home.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`Home`](Home). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. @@ -22,17 +22,17 @@ Terdapat sebelas aliran kerja dalam repositori ini. Aliran kerja **scoped** diha | Aliran kerja | Fail | Jenis | Bermula apabila | Tujuan | | --- | --- | --- | --- | --- | -| Sync GitHub mirror metadata | [`sync-github-metadata.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/scoped_workflows/sync-github-metadata.yml) | Scoped | push ke `main`, manual, setiap hari 03:17 UTC | Menyalin penerangan dan topik repositori Gitea ke push mirror GitHub-nya | -| Publish wiki pages | [`publish-wiki-pages.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/publish-wiki-pages.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Menerbitkan halaman dalam `docs/wiki/` (atau folder yang dinamakan oleh `wiki_dir`) ke wiki repositori pemanggil | -| Quality checks | [`quality-checks.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/quality-checks.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Menjalankan ruff, mypy, shellcheck dan shfmt pada fail yang dijejaki dan tidak mengubah apa-apa | -| Quality checks C++ | [`quality-checks-cpp.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/quality-checks-cpp.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Menjalankan clang-format dan clang-tidy pada versi tepat pada fail C dan C++ yang dijejaki dan tidak mengubah apa-apa | -| Quality checks C# | [`quality-checks-csharp.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/quality-checks-csharp.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Menjalankan `dotnet format` dan `dotnet build` pada .NET SDK 10 atau lebih baharu yang tepat dan tidak mengubah apa-apa | -| Code metrics | [`code-metrics.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/code-metrics.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Mengira fail kod dan baris kod (tanpa baris komen dan baris kosong), membaca laporan liputan Cobertura dan melakukan commit tiga lencana SVG ke cabang `badges` | -| English comments | [`english-comments.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/english-comments.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain, pada pull request | Menilai bahasa komen dan docstring yang ditambah oleh pull request, menggagalkan larian apabila ada yang bukan bahasa Inggeris dan menulis satu komen pada pull request yang menyebut penulisnya | -| Publish own wiki | [`publish-own-wiki.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/publish-own-wiki.yml) | Repositori ini sahaja | push ke `main` yang mengubah `docs/wiki/**`, manual | Memanggil aliran kerja boleh guna semula Publish wiki pages untuk wiki repositori ini | -| Release | [`release.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/release.yml) | Repositori ini sahaja | manual | Mencipta tag versi, halaman keluaran dan tag major selepas semakan | -| Menerbitkan milestone yang diterima | [`sync-milestones.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/sync-milestones.yml) | Repositori ini sahaja | push ke `main` yang mengubah `docs/milestones/**` atau `docs/sqa/reviews/**`, manual (larian percubaan secara lalai) | Mencipta atau mengemas kini milestone Gitea dan isu bagi setiap milestone yang Accepted dengan semakan Go | -| Validate workflows | [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/validate-workflows.yml) | Repositori ini sahaja | pull request, push ke `main`, manual | Menghurai setiap aliran kerja sebagai YAML dan menjalankan ujian luar talian | +| Sync GitHub mirror metadata | [`sync-github-metadata.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/scoped_workflows/sync-github-metadata.yml) | Scoped | push ke `main`, manual, setiap hari 03:17 UTC | Menyalin penerangan dan topik repositori Gitea ke push mirror GitHub-nya | +| Publish wiki pages | [`publish-wiki-pages.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/publish-wiki-pages.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Menerbitkan halaman dalam `docs/wiki/` (atau folder yang dinamakan oleh `wiki_dir`) ke wiki repositori pemanggil | +| Quality checks | [`quality-checks.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/quality-checks.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Menjalankan ruff, mypy, shellcheck dan shfmt pada fail yang dijejaki dan tidak mengubah apa-apa | +| Quality checks C++ | [`quality-checks-cpp.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/quality-checks-cpp.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Menjalankan clang-format dan clang-tidy pada versi tepat pada fail C dan C++ yang dijejaki dan tidak mengubah apa-apa | +| Quality checks C# | [`quality-checks-csharp.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/quality-checks-csharp.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Menjalankan `dotnet format` dan `dotnet build` pada .NET SDK 10 atau lebih baharu yang tepat dan tidak mengubah apa-apa | +| Code metrics | [`code-metrics.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/code-metrics.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain | Mengira fail kod dan baris kod (tanpa baris komen dan baris kosong), membaca laporan liputan Cobertura dan melakukan commit tiga lencana SVG ke cabang `badges` | +| English comments | [`english-comments.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/english-comments.yml) | Boleh guna semula (`workflow_call`) | panggilan daripada repositori lain, pada pull request | Menilai bahasa komen dan docstring yang ditambah oleh pull request, menggagalkan larian apabila ada yang bukan bahasa Inggeris dan menulis satu komen pada pull request yang menyebut penulisnya | +| Publish own wiki | [`publish-own-wiki.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/publish-own-wiki.yml) | Repositori ini sahaja | push ke `main` yang mengubah `docs/wiki/**`, manual | Memanggil aliran kerja boleh guna semula Publish wiki pages untuk wiki repositori ini | +| Release | [`release.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/release.yml) | Repositori ini sahaja | manual | Mencipta tag versi, halaman keluaran dan tag major selepas semakan | +| Menerbitkan milestone yang diterima | [`sync-milestones.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/sync-milestones.yml) | Repositori ini sahaja | push ke `main` yang mengubah `docs/milestones/**` atau `docs/sqa/reviews/**`, manual (larian percubaan secara lalai) | Mencipta atau mengemas kini milestone Gitea dan isu bagi setiap milestone yang Accepted dengan semakan Go | +| Validate workflows | [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/validate-workflows.yml) | Repositori ini sahaja | pull request, push ke `main`, manual | Menghurai setiap aliran kerja sebagai YAML dan menjalankan ujian luar talian | ### Menyegerakkan metadata GitHub @@ -102,7 +102,7 @@ deactivate Workflow ### Semakan kualiti -Aliran kerja boleh guna semula untuk Python dan shell, dipanggil dengan `uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v1` (lihat [panduan](QualityChecksPythonShell)). +Aliran kerja boleh guna semula untuk Python dan shell, dipanggil dengan `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v1` (lihat [panduan](QualityChecksPythonShell)). #### Aliran kerja @@ -148,7 +148,7 @@ deactivate Workflow ### Semakan kualiti C++ -Aliran kerja boleh guna semula untuk C dan C++, dipanggil dengan `uses: TirSystem/github-action/.gitea/workflows/quality-checks-cpp.yml@v1` (ADR-0008). Repositori mesti mempunyai `.clang-format`; `.clang-tidy` dan pangkalan data kompilasi adalah pilihan. +Aliran kerja boleh guna semula untuk C dan C++, dipanggil dengan `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-cpp.yml@v1` (ADR-0008). Repositori mesti mempunyai `.clang-format`; `.clang-tidy` dan pangkalan data kompilasi adalah pilihan. #### Aliran kerja @@ -193,7 +193,7 @@ deactivate Workflow ### Semakan kualiti C# -Aliran kerja boleh guna semula untuk C#, dipanggil dengan `uses: TirSystem/github-action/.gitea/workflows/quality-checks-csharp.yml@v1` (ADR-0008). Ia memasang .NET SDK tepat yang diberikan oleh `dotnet-sdk-version` (10 atau lebih baharu) dan memerlukan rangkaian untuk pemulihan pakej. +Aliran kerja boleh guna semula untuk C#, dipanggil dengan `uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-csharp.yml@v1` (ADR-0008). Ia memasang .NET SDK tepat yang diberikan oleh `dotnet-sdk-version` (10 atau lebih baharu) dan memerlukan rangkaian untuk pemulihan pakej. #### Aliran kerja @@ -238,7 +238,7 @@ deactivate Workflow ### Metrik kod dan lencana liputan -Aliran kerja boleh guna semula yang mengira fail kod dan baris kod (tanpa baris komen dan baris kosong) sesebuah repositori dan menerbitkannya, bersama liputan ujian, sebagai tiga lencana SVG pada cabang `badges`, dipanggil dengan `uses: TirSystem/github-action/.gitea/workflows/code-metrics.yml@v2` (ADR-0010). Ia memerlukan `contents: write` dan tidak menjalankan sebarang ujian: kerja yang lebih awal oleh pemanggil menghasilkan laporan liputan format Cobertura XML dan memuat naiknya sebagai artifak ([panduan](CodeMetrics.ms)). +Aliran kerja boleh guna semula yang mengira fail kod dan baris kod (tanpa baris komen dan baris kosong) sesebuah repositori dan menerbitkannya, bersama liputan ujian, sebagai tiga lencana SVG pada cabang `badges`, dipanggil dengan `uses: TirSystem/git-workflows/.gitea/workflows/code-metrics.yml@v2` (ADR-0010). Ia memerlukan `contents: write` dan tidak menjalankan sebarang ujian: kerja yang lebih awal oleh pemanggil menghasilkan laporan liputan format Cobertura XML dan memuat naiknya sebagai artifak ([panduan](CodeMetrics.ms)). #### Aliran kerja @@ -322,7 +322,7 @@ deactivate Workflow ### Keluaran -Dimulakan secara manual oleh penyelenggara; dengan `dry_run` `true` (lalai) ia hanya menyemak (lihat [proses keluaran](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/release-process.md)). +Dimulakan secara manual oleh penyelenggara; dengan `dry_run` `true` (lalai) ia hanya menyemak (lihat [proses keluaran](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/release-process.md)). #### Aliran kerja @@ -380,7 +380,7 @@ on: paths: [ "docs/wiki/**" ] jobs: wiki: - uses: TirSystem/github-action/.gitea/workflows/publish-wiki-pages.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/publish-wiki-pages.yml@v1 secrets: TOKEN_FOR_GITEA_WIKI: ${{ secrets.TOKEN_FOR_GITEA_WIKI }} ``` @@ -548,7 +548,7 @@ Tiada kebergantungan perlu dipasang; aliran kerja hanya menggunakan pustaka stan 1. Klon repositori: ```bash - git clone ssh://git@git.tirsystem.com:10022/TirSystem/github-action.git + git clone ssh://git@git.tirsystem.com:10022/TirSystem/git-workflows.git ``` 2. Tambah rahsia yang disenaraikan di bawah [Keperluan](#keperluan) ke tetapan repositori dalam Gitea. 3. Konfigurasikan push mirror GitHub dalam tetapan repositori. @@ -571,6 +571,6 @@ python -m coverage run -m pytest -q tests python -m coverage report ``` -Semakan yang sama dijalankan pada setiap pull request dan setiap push ke `main` melalui [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/.gitea/workflows/validate-workflows.yml). Semakan itu menghurai setiap aliran kerja sebagai YAML, memastikan tiada yang menanam Python, mengkompil skrip dalam `tools/`, memerlukan kebenaran kerja yang jelas, dan menguji penghuraian kelayakan (credentials), penghuraian alamat push mirror serta aliran penyegerakan dan penerbitan terhadap API palsu. Larian gagal apabila liputan baris dan cabang `tools/` di bawah 95% (`.coveragerc`). +Semakan yang sama dijalankan pada setiap pull request dan setiap push ke `main` melalui [`validate-workflows.yml`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/.gitea/workflows/validate-workflows.yml). Semakan itu menghurai setiap aliran kerja sebagai YAML, memastikan tiada yang menanam Python, mengkompil skrip dalam `tools/`, memerlukan kebenaran kerja yang jelas, dan menguji penghuraian kelayakan (credentials), penghuraian alamat push mirror serta aliran penyegerakan dan penerbitan terhadap API palsu. Larian gagal apabila liputan baris dan cabang `tools/` di bawah 95% (`.coveragerc`). Selepas perubahan pada aliran kerja penyegerakan, cetuskan juga **Sync GitHub mirror metadata** secara manual dalam Gitea dan bandingkan penerangan dan topik pada cermin GitHub. diff --git a/docs/wiki/Onboarding.da.md b/docs/wiki/Onboarding.da.md index 6da3723..5b7def4 100644 --- a/docs/wiki/Onboarding.da.md +++ b/docs/wiki/Onboarding.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`Onboarding`](Onboarding). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -6,7 +6,7 @@ # Tilslutning af et repository -Sådan får en DevOps-professionel et TirSystem-repository til at bruge det fælles workflow **Sync GitHub mirror metadata**, og hvilke runners det kræver. Kun dette workflow findes i dag; workflows til kvalitetskontrol og udgivelse er planlagt (se [projektplanen](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/docs/project-plan.md)). +Sådan får en DevOps-professionel et TirSystem-repository til at bruge det fælles workflow **Sync GitHub mirror metadata**, og hvilke runners det kræver. Kun dette workflow findes i dag; workflows til kvalitetskontrol og udgivelse er planlagt (se [projektplanen](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/docs/project-plan.md)). ## Hvad er verificeret @@ -45,7 +45,7 @@ Det genbrugelige workflow **Publish wiki pages** kopierer Markdown-siderne i `do paths: [ "docs/wiki/**" ] jobs: wiki: - uses: TirSystem/github-action/.gitea/workflows/publish-wiki-pages.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/publish-wiki-pages.yml@v1 with: prune: "true" secrets: diff --git a/docs/wiki/Onboarding.md b/docs/wiki/Onboarding.md index c0b1884..cc9b75f 100644 --- a/docs/wiki/Onboarding.md +++ b/docs/wiki/Onboarding.md @@ -1,6 +1,6 @@ -> This page is generated from [`guides/onboarding.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/onboarding.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`guides/onboarding.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/onboarding.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](Onboarding.da) | [Bahasa Melayu](Onboarding.ms) @@ -9,7 +9,7 @@ English | [Dansk](Onboarding.da) | [Bahasa Melayu](Onboarding.ms) How a DevOps professional makes a TirSystem repository use the shared **Sync GitHub mirror metadata** workflow, and which runners it needs. Only this workflow exists today; the quality-check and release workflows are -planned (see the [Project Plan](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/docs/project-plan.md)). +planned (see the [Project Plan](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/docs/project-plan.md)). ## What has been verified @@ -59,7 +59,7 @@ The wiki has English and the product owner's language as a minimum. 1. Enable the wiki in the repository settings. 2. Add Markdown pages to `docs/wiki/`. The file name is the page name: `Home.md` is the home page. A hyphen in the name is a space in the page name: - `Home-da.md` is the page "Home da", and a link to it is `[Dansk](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/Home-da)`. + `Home-da.md` is the page "Home da", and a link to it is `[Dansk](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/Home-da)`. 3. Add a workflow, for example `.gitea/workflows/publish-wiki.yml`, that calls the reusable workflow: @@ -70,7 +70,7 @@ The wiki has English and the product owner's language as a minimum. paths: [ "docs/wiki/**" ] jobs: wiki: - uses: TirSystem/github-action/.gitea/workflows/publish-wiki-pages.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/publish-wiki-pages.yml@v1 with: prune: "true" secrets: diff --git a/docs/wiki/Onboarding.ms.md b/docs/wiki/Onboarding.ms.md index 3340274..475ed0d 100644 --- a/docs/wiki/Onboarding.ms.md +++ b/docs/wiki/Onboarding.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`Onboarding`](Onboarding). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. @@ -6,7 +6,7 @@ # Menyertakan sebuah repositori -Cara seorang profesional DevOps menjadikan repositori TirSystem menggunakan aliran kerja bersama **Sync GitHub mirror metadata**, dan runner yang diperlukannya. Hanya aliran kerja ini yang wujud sekarang; aliran kerja semakan kualiti dan keluaran dirancang (lihat [Pelan Projek](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/docs/project-plan.md)). +Cara seorang profesional DevOps menjadikan repositori TirSystem menggunakan aliran kerja bersama **Sync GitHub mirror metadata**, dan runner yang diperlukannya. Hanya aliran kerja ini yang wujud sekarang; aliran kerja semakan kualiti dan keluaran dirancang (lihat [Pelan Projek](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/docs/project-plan.md)). ## Perkara yang telah disahkan @@ -45,7 +45,7 @@ Aliran kerja boleh guna semula **Publish wiki pages** menyalin halaman Markdown paths: [ "docs/wiki/**" ] jobs: wiki: - uses: TirSystem/github-action/.gitea/workflows/publish-wiki-pages.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/publish-wiki-pages.yml@v1 with: prune: "true" secrets: diff --git a/docs/wiki/QualityChecksCSharp.da.md b/docs/wiki/QualityChecksCSharp.da.md index fababdb..1e4589a 100644 --- a/docs/wiki/QualityChecksCSharp.da.md +++ b/docs/wiki/QualityChecksCSharp.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`QualityChecksCSharp`](QualityChecksCSharp). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -22,7 +22,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks-csharp.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-csharp.yml@v1 with: project: src/App.sln ``` @@ -32,7 +32,7 @@ jobs: | `working-directory` | `.` | Mappe, relativt til repositoryets rod, hvis filer kontrolleres | | `project` | tom | Solution- eller projektfil, relativt til `working-directory`; tom bruger den eneste sporede `*.sln` eller `*.slnx`, ellers den eneste `*.csproj`, der er sporet dér | | `dotnet-sdk-version` | `10.0.401` | Præcis version af .NET SDK, 10 eller nyere; en kanal som `10.0`, et interval og en version under 10 afvises | -| `tools-ref` | `v2` | Tag eller gren i `TirSystem/github-action`, hvorfra scriptet `tools/quality-checks-csharp.sh` hentes | +| `tools-ref` | `v2` | Tag eller gren i `TirSystem/git-workflows`, hvorfra scriptet `tools/quality-checks-csharp.sh` hentes | Henvis til workflowet ved major-tagget (`@v1`) eller et præcist tag, aldrig ved `main`. Et kald ved et præcist tag er kun fuldt fastlåst, når `tools-ref` angiver samme tag. Se opgraderingsvejledningen. SDK-versionen er præcis: at hæve standardværdien er en ny udgivelse af dette repository, ikke en stille ændring. diff --git a/docs/wiki/QualityChecksCSharp.md b/docs/wiki/QualityChecksCSharp.md index 610899f..897fbed 100644 --- a/docs/wiki/QualityChecksCSharp.md +++ b/docs/wiki/QualityChecksCSharp.md @@ -1,6 +1,6 @@ -> This page is generated from [`guides/quality-checks-csharp.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/quality-checks-csharp.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`guides/quality-checks-csharp.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/quality-checks-csharp.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](QualityChecksCSharp.da) | [Bahasa Melayu](QualityChecksCSharp.ms) @@ -26,7 +26,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks-csharp.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-csharp.yml@v1 with: project: src/App.sln ``` @@ -36,7 +36,7 @@ jobs: | `working-directory` | `.` | Directory, relative to the repository root, whose files are checked | | `project` | empty | Solution or project file, relative to `working-directory`; empty uses the single `*.sln` or `*.slnx`, else the single `*.csproj`, that is tracked there | | `dotnet-sdk-version` | `10.0.401` | Exact version of the .NET SDK, 10 or later; a channel such as `10.0`, a range and a version below 10 are refused | -| `tools-ref` | `v2` | Tag or branch of `TirSystem/github-action` from which the script `tools/quality-checks-csharp.sh` is fetched | +| `tools-ref` | `v2` | Tag or branch of `TirSystem/git-workflows` from which the script `tools/quality-checks-csharp.sh` is fetched | Reference the workflow at the major tag (`@v1`) or at an exact tag, never at `main`. A call at an exact tag is pinned completely only when `tools-ref` names diff --git a/docs/wiki/QualityChecksCSharp.ms.md b/docs/wiki/QualityChecksCSharp.ms.md index 2054f55..2ba3c9e 100644 --- a/docs/wiki/QualityChecksCSharp.ms.md +++ b/docs/wiki/QualityChecksCSharp.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`QualityChecksCSharp`](QualityChecksCSharp). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. @@ -22,7 +22,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks-csharp.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-csharp.yml@v1 with: project: src/App.sln ``` @@ -32,7 +32,7 @@ jobs: | `working-directory` | `.` | Direktori, relatif kepada akar repositori, yang failnya disemak | | `project` | kosong | Fail solution atau projek, relatif kepada `working-directory`; kosong menggunakan satu-satunya `*.sln` atau `*.slnx` yang dijejaki, jika tiada maka satu-satunya `*.csproj` yang dijejaki di situ | | `dotnet-sdk-version` | `10.0.401` | Versi tepat .NET SDK, 10 atau lebih baharu; saluran seperti `10.0`, julat dan versi di bawah 10 ditolak | -| `tools-ref` | `v2` | Tag atau cabang `TirSystem/github-action` tempat skrip `tools/quality-checks-csharp.sh` diambil | +| `tools-ref` | `v2` | Tag atau cabang `TirSystem/git-workflows` tempat skrip `tools/quality-checks-csharp.sh` diambil | Rujuk aliran kerja pada tag major (`@v1`) atau pada tag tepat, jangan sekali-kali pada `main`. Panggilan pada tag tepat hanya disematkan sepenuhnya apabila `tools-ref` menamakan tag yang sama. Lihat panduan naik taraf. Versi SDK adalah tepat: menaikkan nilai lalai ialah keluaran baharu repositori ini, bukan perubahan senyap. diff --git a/docs/wiki/QualityChecksCpp.da.md b/docs/wiki/QualityChecksCpp.da.md index 8070c36..eda2e9a 100644 --- a/docs/wiki/QualityChecksCpp.da.md +++ b/docs/wiki/QualityChecksCpp.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`QualityChecksCpp`](QualityChecksCpp). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -22,7 +22,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks-cpp.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-cpp.yml@v1 with: std: c++20 ``` @@ -34,7 +34,7 @@ jobs: | `compile-commands-dir` | tom | Mappe, relativt til repositoryets rod, med en `compile_commands.json`, som din pipeline har bygget før kaldet; når den er sat, bruger clang-tidy den og ignorerer `std` | | `clang-format-version` | `23.1.3` | Præcis version af pakken clang-format | | `clang-tidy-version` | `22.1.8` | Præcis version af pakken clang-tidy | -| `tools-ref` | `v2` | Tag eller gren i `TirSystem/github-action`, hvorfra scriptet `tools/quality-checks-cpp.sh` hentes | +| `tools-ref` | `v2` | Tag eller gren i `TirSystem/git-workflows`, hvorfra scriptet `tools/quality-checks-cpp.sh` hentes | Henvis til workflowet ved major-tagget (`@v1`) eller et præcist tag, aldrig ved `main`. Et kald ved et præcist tag er kun fuldt fastlåst, når `tools-ref` angiver samme tag. Se opgraderingsvejledningen. Værktøjsversionerne er præcise: en nyere version af et værktøj er en ny udgivelse af dette repository, ikke en stille ændring. diff --git a/docs/wiki/QualityChecksCpp.md b/docs/wiki/QualityChecksCpp.md index 5b0f7cd..3023166 100644 --- a/docs/wiki/QualityChecksCpp.md +++ b/docs/wiki/QualityChecksCpp.md @@ -1,6 +1,6 @@ -> This page is generated from [`guides/quality-checks-cpp.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/quality-checks-cpp.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`guides/quality-checks-cpp.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/quality-checks-cpp.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](QualityChecksCpp.da) | [Bahasa Melayu](QualityChecksCpp.ms) @@ -25,7 +25,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks-cpp.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-cpp.yml@v1 with: std: c++20 ``` @@ -37,7 +37,7 @@ jobs: | `compile-commands-dir` | empty | Directory, relative to the repository root, with a `compile_commands.json` that your pipeline built before the call; when set, clang-tidy uses it and ignores `std` | | `clang-format-version` | `23.1.3` | Exact version of the clang-format package | | `clang-tidy-version` | `22.1.8` | Exact version of the clang-tidy package | -| `tools-ref` | `v2` | Tag or branch of `TirSystem/github-action` from which the script `tools/quality-checks-cpp.sh` is fetched | +| `tools-ref` | `v2` | Tag or branch of `TirSystem/git-workflows` from which the script `tools/quality-checks-cpp.sh` is fetched | Reference the workflow at the major tag (`@v1`) or at an exact tag, never at `main`. A call at an exact tag is pinned completely only when `tools-ref` names diff --git a/docs/wiki/QualityChecksCpp.ms.md b/docs/wiki/QualityChecksCpp.ms.md index a70ca43..9195280 100644 --- a/docs/wiki/QualityChecksCpp.ms.md +++ b/docs/wiki/QualityChecksCpp.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`QualityChecksCpp`](QualityChecksCpp). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. @@ -22,7 +22,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks-cpp.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-cpp.yml@v1 with: std: c++20 ``` @@ -34,7 +34,7 @@ jobs: | `compile-commands-dir` | kosong | Direktori, relatif kepada akar repositori, dengan `compile_commands.json` yang dibina oleh saluran paip anda sebelum panggilan; apabila ditetapkan, clang-tidy menggunakannya dan mengabaikan `std` | | `clang-format-version` | `23.1.3` | Versi tepat pakej clang-format | | `clang-tidy-version` | `22.1.8` | Versi tepat pakej clang-tidy | -| `tools-ref` | `v2` | Tag atau cabang `TirSystem/github-action` tempat skrip `tools/quality-checks-cpp.sh` diambil | +| `tools-ref` | `v2` | Tag atau cabang `TirSystem/git-workflows` tempat skrip `tools/quality-checks-cpp.sh` diambil | Rujuk aliran kerja pada tag major (`@v1`) atau pada tag tepat, jangan sekali-kali pada `main`. Panggilan pada tag tepat hanya disematkan sepenuhnya apabila `tools-ref` menamakan tag yang sama. Lihat panduan naik taraf. Versi alat adalah tepat: versi alat yang lebih baharu ialah keluaran baharu repositori ini, bukan perubahan senyap. diff --git a/docs/wiki/QualityChecksPythonShell.da.md b/docs/wiki/QualityChecksPythonShell.da.md index 13b45c1..d420b66 100644 --- a/docs/wiki/QualityChecksPythonShell.da.md +++ b/docs/wiki/QualityChecksPythonShell.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`QualityChecksPythonShell`](QualityChecksPythonShell). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -22,7 +22,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v1 with: languages: python,shell ``` @@ -35,7 +35,7 @@ jobs: | `mypy-version` | `1.11.2` | Version af mypy | | `shellcheck-py-version` | `0.10.0.1` | Version af pakken shellcheck-py (ShellCheck 0.10.0) | | `shfmt-py-version` | `3.11.0.2` | Version af pakken shfmt-py (shfmt 3.11.0) | -| `tools-ref` | `v2` | Tag eller gren i `TirSystem/github-action`, hvorfra scriptet `tools/quality-checks.sh` hentes | +| `tools-ref` | `v2` | Tag eller gren i `TirSystem/git-workflows`, hvorfra scriptet `tools/quality-checks.sh` hentes | Henvis til workflowet ved major-tagget (`@v1`) eller et præcist tag (`@v1.0.0`), aldrig ved `main` og aldrig ved en pull requests gren: den gren slettes, når pull requesten flettes, og henvisningen holder op med at virke. Se opgraderingsvejledningen for, hvad hvert valg modtager. diff --git a/docs/wiki/QualityChecksPythonShell.md b/docs/wiki/QualityChecksPythonShell.md index b628305..7730754 100644 --- a/docs/wiki/QualityChecksPythonShell.md +++ b/docs/wiki/QualityChecksPythonShell.md @@ -1,6 +1,6 @@ -> This page is generated from [`guides/quality-checks.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/quality-checks.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`guides/quality-checks.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/quality-checks.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](QualityChecksPythonShell.da) | [Bahasa Melayu](QualityChecksPythonShell.ms) @@ -25,7 +25,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v1 with: languages: python,shell ``` @@ -38,7 +38,7 @@ jobs: | `mypy-version` | `1.11.2` | Version of mypy | | `shellcheck-py-version` | `0.10.0.1` | Version of the shellcheck-py package (ShellCheck 0.10.0) | | `shfmt-py-version` | `3.11.0.2` | Version of the shfmt-py package (shfmt 3.11.0) | -| `tools-ref` | `v2` | Tag or branch of `TirSystem/github-action` from which the script `tools/quality-checks.sh` is fetched | +| `tools-ref` | `v2` | Tag or branch of `TirSystem/git-workflows` from which the script `tools/quality-checks.sh` is fetched | Reference the workflow at the major tag (`@v1`) or at an exact tag (`@v1.0.0`), never at `main` and never at the branch of a pull request: that diff --git a/docs/wiki/QualityChecksPythonShell.ms.md b/docs/wiki/QualityChecksPythonShell.ms.md index c735f4b..d7e9431 100644 --- a/docs/wiki/QualityChecksPythonShell.ms.md +++ b/docs/wiki/QualityChecksPythonShell.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`QualityChecksPythonShell`](QualityChecksPythonShell). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. @@ -22,7 +22,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v1 with: languages: python,shell ``` @@ -35,7 +35,7 @@ jobs: | `mypy-version` | `1.11.2` | Versi mypy | | `shellcheck-py-version` | `0.10.0.1` | Versi pakej shellcheck-py (ShellCheck 0.10.0) | | `shfmt-py-version` | `3.11.0.2` | Versi pakej shfmt-py (shfmt 3.11.0) | -| `tools-ref` | `v2` | Tag atau cabang `TirSystem/github-action` tempat skrip `tools/quality-checks.sh` diambil | +| `tools-ref` | `v2` | Tag atau cabang `TirSystem/git-workflows` tempat skrip `tools/quality-checks.sh` diambil | Rujuk aliran kerja pada tag major (`@v1`) atau pada tag tepat (`@v1.0.0`), jangan sekali-kali pada `main` dan jangan pada cabang pull request: cabang itu dipadam apabila pull request digabungkan dan rujukan itu berhenti berfungsi. Lihat panduan naik taraf untuk apa yang diterima oleh setiap pilihan. diff --git a/docs/wiki/Troubleshooting.da.md b/docs/wiki/Troubleshooting.da.md index 77119c0..0b1a3f3 100644 --- a/docs/wiki/Troubleshooting.da.md +++ b/docs/wiki/Troubleshooting.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`Troubleshooting`](Troubleshooting). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. diff --git a/docs/wiki/Troubleshooting.md b/docs/wiki/Troubleshooting.md index c877c6c..7c1d6fa 100644 --- a/docs/wiki/Troubleshooting.md +++ b/docs/wiki/Troubleshooting.md @@ -1,6 +1,6 @@ -> This page is generated from [`guides/troubleshooting.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/troubleshooting.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`guides/troubleshooting.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/troubleshooting.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](Troubleshooting.da) | [Bahasa Melayu](Troubleshooting.ms) diff --git a/docs/wiki/Troubleshooting.ms.md b/docs/wiki/Troubleshooting.ms.md index b8748ce..d099cf1 100644 --- a/docs/wiki/Troubleshooting.ms.md +++ b/docs/wiki/Troubleshooting.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`Troubleshooting`](Troubleshooting). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. diff --git a/docs/wiki/Upgrading.da.md b/docs/wiki/Upgrading.da.md index 3ad53d2..c0183d9 100644 --- a/docs/wiki/Upgrading.da.md +++ b/docs/wiki/Upgrading.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`Upgrading`](Upgrading). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -24,7 +24,7 @@ Det scoped workflow **Sync GitHub mirror metadata** leveres af instansen og stå ## Aflæsning af en changelog-post -Åbn `CHANGELOG.md` i `TirSystem/github-action` eller tagget udgivelsesside. En post har op til fire grupper: +Åbn `CHANGELOG.md` i `TirSystem/git-workflows` eller tagget udgivelsesside. En post har op til fire grupper: | Gruppe | Hvad den betyder for dig | | --- | --- | @@ -41,7 +41,7 @@ En post, der ændrer credentials, tokens eller tilladelser, siger det; kontrolle ```yaml jobs: quality: - uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v2 ``` 2. Åbn en pull request, og læs kørslen. En mislykket kontrol viser værktøj, fil og meddelelse (se vejledningen til aflæsning af kvalitetskontrollens resultater). 3. For en udgivelse, der bryder kompatibiliteten, følges opgraderingsnoterne i changelog-posten, og trinnet gentages. diff --git a/docs/wiki/Upgrading.md b/docs/wiki/Upgrading.md index d46393d..b70d9ad 100644 --- a/docs/wiki/Upgrading.md +++ b/docs/wiki/Upgrading.md @@ -1,6 +1,6 @@ -> This page is generated from [`guides/upgrading.md`](https://git.tirsystem.com/TirSystem/github-action/src/branch/main/guides/upgrading.md). Changes made here are overwritten the next time the wiki is published. +> This page is generated from [`guides/upgrading.md`](https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main/guides/upgrading.md). Changes made here are overwritten the next time the wiki is published. English | [Dansk](Upgrading.da) | [Bahasa Melayu](Upgrading.ms) @@ -37,7 +37,7 @@ onboarding guide). ## Reading a changelog entry -Open `CHANGELOG.md` of `TirSystem/github-action`, or the release page of the tag. +Open `CHANGELOG.md` of `TirSystem/git-workflows`, or the release page of the tag. An entry has up to four groups: | Group | What it means for you | @@ -56,7 +56,7 @@ secrets before you upgrade. ```yaml jobs: quality: - uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v2 ``` 2. Open a pull request and read the run. A failing check shows the tool, the file and the message (see the guide for reading quality-check results). diff --git a/docs/wiki/Upgrading.ms.md b/docs/wiki/Upgrading.ms.md index 04218ad..5b9cfb0 100644 --- a/docs/wiki/Upgrading.ms.md +++ b/docs/wiki/Upgrading.ms.md @@ -1,4 +1,4 @@ - + > Ini ialah terjemahan [`Upgrading`](Upgrading). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. @@ -24,7 +24,7 @@ Aliran kerja scoped **Sync GitHub mirror metadata** dihantar oleh instans dan ti ## Membaca satu catatan changelog -Buka `CHANGELOG.md` bagi `TirSystem/github-action`, atau halaman keluaran tag itu. Satu catatan mempunyai sehingga empat kumpulan: +Buka `CHANGELOG.md` bagi `TirSystem/git-workflows`, atau halaman keluaran tag itu. Satu catatan mempunyai sehingga empat kumpulan: | Kumpulan | Maksudnya untuk anda | | --- | --- | @@ -41,7 +41,7 @@ Catatan yang mengubah kelayakan (credentials), token atau kebenaran menyatakanny ```yaml jobs: quality: - uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v2 ``` 2. Buka pull request dan baca larian. Semakan yang gagal menunjukkan alat, fail dan mesej (lihat panduan membaca keputusan semakan kualiti). 3. Bagi keluaran yang memecahkan keserasian, ikut nota naik taraf dalam catatan changelog, kemudian ulang. diff --git a/guides/code-metrics.md b/guides/code-metrics.md index c511d22..199c09f 100644 --- a/guides/code-metrics.md +++ b/guides/code-metrics.md @@ -34,7 +34,7 @@ jobs: needs: tests permissions: contents: write - uses: TirSystem/github-action/.gitea/workflows/code-metrics.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/code-metrics.yml@v2 with: coverage-artifact: coverage coverage-report: coverage.xml @@ -49,7 +49,7 @@ jobs: | `coverage-warn` | `60` | Coverage in percent below which the badge is red | | `coverage-good` | `80` | Coverage in percent from which the badge is green; in between it is yellow | | `badges-branch` | `badges` | Branch that holds the badge files; it is created when it does not exist | -| `tools-ref` | `v2` | Tag or branch of `TirSystem/github-action` from which the scripts in `tools/` are fetched | +| `tools-ref` | `v2` | Tag or branch of `TirSystem/git-workflows` from which the scripts in `tools/` are fetched | Reference the workflow at the major tag (`@v2`) or at an exact tag, never at `main`. A call at an exact tag is pinned completely only when `tools-ref` names diff --git a/guides/english-comments.md b/guides/english-comments.md index 95ac358..d173862 100644 --- a/guides/english-comments.md +++ b/guides/english-comments.md @@ -16,7 +16,7 @@ on: jobs: english-comments: - uses: TirSystem/github-action/.gitea/workflows/english-comments.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/english-comments.yml@v2 with: exclude: "docs/generated/**" allowed-words-file: .english-comments-allowed-words diff --git a/guides/onboarding.md b/guides/onboarding.md index c7a8a86..0d2e110 100644 --- a/guides/onboarding.md +++ b/guides/onboarding.md @@ -64,7 +64,7 @@ The wiki has English and the product owner's language as a minimum. paths: [ "docs/wiki/**" ] jobs: wiki: - uses: TirSystem/github-action/.gitea/workflows/publish-wiki-pages.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/publish-wiki-pages.yml@v1 with: prune: "true" secrets: diff --git a/guides/quality-checks-cpp.md b/guides/quality-checks-cpp.md index 19960d0..d5de21f 100644 --- a/guides/quality-checks-cpp.md +++ b/guides/quality-checks-cpp.md @@ -19,7 +19,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks-cpp.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-cpp.yml@v1 with: std: c++20 ``` @@ -31,7 +31,7 @@ jobs: | `compile-commands-dir` | empty | Directory, relative to the repository root, with a `compile_commands.json` that your pipeline built before the call; when set, clang-tidy uses it and ignores `std` | | `clang-format-version` | `23.1.3` | Exact version of the clang-format package | | `clang-tidy-version` | `22.1.8` | Exact version of the clang-tidy package | -| `tools-ref` | `v2` | Tag or branch of `TirSystem/github-action` from which the script `tools/quality-checks-cpp.sh` is fetched | +| `tools-ref` | `v2` | Tag or branch of `TirSystem/git-workflows` from which the script `tools/quality-checks-cpp.sh` is fetched | Reference the workflow at the major tag (`@v1`) or at an exact tag, never at `main`. A call at an exact tag is pinned completely only when `tools-ref` names diff --git a/guides/quality-checks-csharp.md b/guides/quality-checks-csharp.md index 3fd4963..10bab0c 100644 --- a/guides/quality-checks-csharp.md +++ b/guides/quality-checks-csharp.md @@ -20,7 +20,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks-csharp.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks-csharp.yml@v1 with: project: src/App.sln ``` @@ -30,7 +30,7 @@ jobs: | `working-directory` | `.` | Directory, relative to the repository root, whose files are checked | | `project` | empty | Solution or project file, relative to `working-directory`; empty uses the single `*.sln` or `*.slnx`, else the single `*.csproj`, that is tracked there | | `dotnet-sdk-version` | `10.0.401` | Exact version of the .NET SDK, 10 or later; a channel such as `10.0`, a range and a version below 10 are refused | -| `tools-ref` | `v2` | Tag or branch of `TirSystem/github-action` from which the script `tools/quality-checks-csharp.sh` is fetched | +| `tools-ref` | `v2` | Tag or branch of `TirSystem/git-workflows` from which the script `tools/quality-checks-csharp.sh` is fetched | Reference the workflow at the major tag (`@v1`) or at an exact tag, never at `main`. A call at an exact tag is pinned completely only when `tools-ref` names diff --git a/guides/quality-checks.md b/guides/quality-checks.md index c055b7d..c9e3039 100644 --- a/guides/quality-checks.md +++ b/guides/quality-checks.md @@ -19,7 +19,7 @@ jobs: quality: permissions: contents: read - uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v1 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v1 with: languages: python,shell ``` @@ -32,7 +32,7 @@ jobs: | `mypy-version` | `1.11.2` | Version of mypy | | `shellcheck-py-version` | `0.10.0.1` | Version of the shellcheck-py package (ShellCheck 0.10.0) | | `shfmt-py-version` | `3.11.0.2` | Version of the shfmt-py package (shfmt 3.11.0) | -| `tools-ref` | `v2` | Tag or branch of `TirSystem/github-action` from which the script `tools/quality-checks.sh` is fetched | +| `tools-ref` | `v2` | Tag or branch of `TirSystem/git-workflows` from which the script `tools/quality-checks.sh` is fetched | Reference the workflow at the major tag (`@v1`) or at an exact tag (`@v1.0.0`), never at `main` and never at the branch of a pull request: that diff --git a/guides/upgrading.md b/guides/upgrading.md index 91dbc52..fa93f61 100644 --- a/guides/upgrading.md +++ b/guides/upgrading.md @@ -31,7 +31,7 @@ onboarding guide). ## Reading a changelog entry -Open `CHANGELOG.md` of `TirSystem/github-action`, or the release page of the tag. +Open `CHANGELOG.md` of `TirSystem/git-workflows`, or the release page of the tag. An entry has up to four groups: | Group | What it means for you | @@ -50,7 +50,7 @@ secrets before you upgrade. ```yaml jobs: quality: - uses: TirSystem/github-action/.gitea/workflows/quality-checks.yml@v2 + uses: TirSystem/git-workflows/.gitea/workflows/quality-checks.yml@v2 ``` 2. Open a pull request and read the run. A failing check shows the tool, the file and the message (see the guide for reading quality-check results). diff --git a/guides/vpn-tailscale.md b/guides/vpn-tailscale.md index 9c13fd1..ea88459 100644 --- a/guides/vpn-tailscale.md +++ b/guides/vpn-tailscale.md @@ -23,7 +23,7 @@ jobs: - uses: actions/checkout@v4.2.2 - name: Connect Tailscale - uses: TirSystem/github-action/actions/connect-tailscale@v2 + uses: TirSystem/git-workflows/actions/connect-tailscale@v2 with: oauth-secret: ${{ secrets.TS_OAUTH_SECRET }} tags: tag:ci @@ -35,14 +35,14 @@ jobs: - name: Disconnect Tailscale if: always() - uses: TirSystem/github-action/actions/connect-tailscale@v2 + uses: TirSystem/git-workflows/actions/connect-tailscale@v2 with: action: down ``` If the short form does not resolve on your instance (Gitea looks for the action on the host set in `DEFAULT_ACTIONS_URL`), use the full address: -`https://git.tirsystem.com/TirSystem/github-action/actions/connect-tailscale@v2`. +`https://git.tirsystem.com/TirSystem/git-workflows/actions/connect-tailscale@v2`. ## Inputs diff --git a/guides/vpn-wireguard.md b/guides/vpn-wireguard.md index 1fd56af..e742e3c 100644 --- a/guides/vpn-wireguard.md +++ b/guides/vpn-wireguard.md @@ -21,7 +21,7 @@ jobs: - uses: actions/checkout@v4.2.2 - name: Connect the VPN - uses: TirSystem/github-action/actions/connect-wireguard@v2 + uses: TirSystem/git-workflows/actions/connect-wireguard@v2 with: config: ${{ secrets.WG_CONFIG }} health-check-host: 10.8.0.1 @@ -31,14 +31,14 @@ jobs: - name: Disconnect the VPN if: always() - uses: TirSystem/github-action/actions/connect-wireguard@v2 + uses: TirSystem/git-workflows/actions/connect-wireguard@v2 with: action: down ``` If the short form does not resolve on your instance (Gitea looks for the action on the host set in `DEFAULT_ACTIONS_URL`), use the full address: -`https://git.tirsystem.com/TirSystem/github-action/actions/connect-wireguard@v2`. +`https://git.tirsystem.com/TirSystem/git-workflows/actions/connect-wireguard@v2`. ## Inputs diff --git a/tests/test_code_metrics.py b/tests/test_code_metrics.py index 5f33bf7..6763a48 100644 --- a/tests/test_code_metrics.py +++ b/tests/test_code_metrics.py @@ -78,7 +78,7 @@ class TestDefinition: steps = document["jobs"]["code-metrics"]["steps"] fetch = next(step for step in steps if step.get("name") == "Fetch the shared scripts") assert fetch["with"] == { - "repository": "TirSystem/github-action", + "repository": "TirSystem/git-workflows", "ref": "${{ inputs.tools-ref }}", "path": "shared-scripts", } diff --git a/tests/test_english_comments_report.py b/tests/test_english_comments_report.py index 8fd40b0..bdc3564 100644 --- a/tests/test_english_comments_report.py +++ b/tests/test_english_comments_report.py @@ -285,4 +285,4 @@ class TestWorkflow: def test_uses_gitea_contexts_only(self): text = WORKFLOW.read_text(encoding="utf-8") assert "gitea.event.pull_request.user.login" in text - assert "github." not in text.replace("TirSystem/github-action", "") + assert "github." not in text.replace("TirSystem/git-workflows", "") diff --git a/tests/test_publish_wiki.py b/tests/test_publish_wiki.py index 0c8cfc7..d1bb49d 100644 --- a/tests/test_publish_wiki.py +++ b/tests/test_publish_wiki.py @@ -492,7 +492,7 @@ class TestReusableWorkflow: def test_the_script_is_fetched_at_the_tools_ref(self, document): fetch = document["jobs"]["publish-wiki"]["steps"][1]["with"] - assert fetch["repository"] == "TirSystem/github-action" + assert fetch["repository"] == "TirSystem/git-workflows" assert fetch["ref"] == "${{ inputs.tools-ref }}" diff --git a/tests/test_quality_workflow.py b/tests/test_quality_workflow.py index 5a24d12..5c6a459 100644 --- a/tests/test_quality_workflow.py +++ b/tests/test_quality_workflow.py @@ -81,7 +81,7 @@ class TestDefinition: steps = document["jobs"]["quality-checks"]["steps"] fetch = next(step for step in steps if step.get("name") == "Fetch the shared script") assert fetch["with"] == { - "repository": "TirSystem/github-action", + "repository": "TirSystem/git-workflows", "ref": "${{ inputs.tools-ref }}", "path": "shared-scripts", } diff --git a/tests/test_quality_workflows_cpp_csharp.py b/tests/test_quality_workflows_cpp_csharp.py index 237e0ba..860a15d 100644 --- a/tests/test_quality_workflows_cpp_csharp.py +++ b/tests/test_quality_workflows_cpp_csharp.py @@ -64,7 +64,7 @@ class TestDefinition: steps = load(workflow)["jobs"][job]["steps"] fetch = next(step for step in steps if step.get("name") == "Fetch the shared script") assert fetch["with"] == { - "repository": "TirSystem/github-action", + "repository": "TirSystem/git-workflows", "ref": "${{ inputs.tools-ref }}", "path": "shared-scripts", } diff --git a/tests/test_sync_github_metadata.py b/tests/test_sync_github_metadata.py index 4daccf8..e1f9c06 100644 --- a/tests/test_sync_github_metadata.py +++ b/tests/test_sync_github_metadata.py @@ -40,9 +40,9 @@ class TestGiteaToken: class TestSplitRepository: def test_splits_owner_and_repo(self, sync): - assert sync["split_repository"]("TirSystem/github-action") == ( + assert sync["split_repository"]("TirSystem/git-workflows") == ( "TirSystem", - "github-action", + "git-workflows", ) @pytest.mark.parametrize("value", [None, "", "owner", "/repo", "owner/"]) diff --git a/tests/test_workflows.py b/tests/test_workflows.py index cd2bd38..6dc53b1 100644 --- a/tests/test_workflows.py +++ b/tests/test_workflows.py @@ -38,7 +38,7 @@ def test_sync_workflow_embeds_no_script_and_runs_the_file(): assert embedded_python(SYNC_WORKFLOW) == [] document = yaml.safe_load(SYNC_WORKFLOW.read_text(encoding="utf-8")) steps = document["jobs"]["sync-metadata"]["steps"] - assert steps[0]["with"]["repository"] == "TirSystem/github-action" + assert steps[0]["with"]["repository"] == "TirSystem/git-workflows" assert steps[-1]["run"] == "python3 shared-scripts/tools/sync_github_metadata.py" diff --git a/tools/build_wiki.py b/tools/build_wiki.py index e949ba7..fdd6de9 100644 --- a/tools/build_wiki.py +++ b/tools/build_wiki.py @@ -19,7 +19,7 @@ from pathlib import Path REPO_ROOT = Path(__file__).resolve().parent.parent WIKI_DIR = REPO_ROOT / "docs" / "wiki" -SOURCE_BASE_URL = "https://git.tirsystem.com/TirSystem/github-action/src/branch/main" +SOURCE_BASE_URL = "https://git.tirsystem.com/TirSystem/git-workflows/src/branch/main" GENERATOR = "tools/build_wiki.py" # Leading emoji and symbols in README headings; removed so anchors stay stable.