docs: add example of company-specific GH action wrapper

Author: laxa1986

CHANGELOG.md

@@ -16,10 +16,6 @@
 
 ## [1.0.0](https://github.com/agilecustoms/release/compare/v0.17.1...v1.0.0) (2025-08-24)
 
-### ⚠ BREAKING CHANGES
-
-* first beta
-
 ### Features
 
 * add java-version input - pass it into setup-maven-codeartifact action ([e707ff4](https://github.com/agilecustoms/release/commit/e707ff4254776e8a6694e1021713b3122a7d2a5c))

docs/best-practices.md

@@ -139,4 +139,19 @@ For more details see [semantic commits](./features/semantic-commits.md)
 
 ## Company-specific gha-release wrapper
 
-TBD
+In many [examples](./examples) you may some inputs repeat, such as `aws-account`, `aws-region`, `aws-role`.
+You can reduce code reputation by creating your own wrapper around `agilecustoms/release`.
+For this just create a new GH repo with single file `action.yml`, see example [gha-release](./examples/gha-release).
+Here you provide company-specific defaults, see comment `# company-specific defaults`.
+For parameters that may vary - you add them in `inputs` section and pass them through, see comment `# pass through inputs`.
+For pass-through inputs you can use either same defaults as in `agilecustoms/release` (like `floating-tags` default is true)
+and for others you may want to set your own defaults (like `summary`).
+
+Especially useful to provide default value for input `release-plugins`.
+This is the recommended way to have shared release configuration among multiple repos.
+Alternative is to have `.releaserc.json` file in each repo, but then you need to maintain it in multiple places.
+See [configuration](./configuration.md) for more details on configuration options.
+
+Tech note. Once you create your custom GH action wrapper, make sure other repos can access it.
+For this go to your repo Settings > Actions > General > "Workflow permissions" > "Access" >
+set "Accessible from repositories in the '_mycompany_' organization"

docs/examples/gha-release/action.yml

@@ -0,0 +1,112 @@
+name: 'Release'
+description: 'MyCompany wrapper for GH action agilecustoms/release'
+inputs:
+  aws-codeartifact-maven:
+    required: false
+  aws-ecr:
+    required: false
+  dev-branch-prefix:
+    required: false
+    default: 'feature/'
+  dev-release:
+    required: false
+    default: 'false'
+  floating-tags:
+    required: false
+    default: 'true'
+  node-version:
+    required: false
+    default: '22'
+  pre-publish-script:
+    required: false
+  release-channel:
+    required: false
+  release-gh:
+    required: false
+    default: 'true'
+  release-plugins:
+    required: false
+    default: |
+      [
+        [
+          "@semantic-release/commit-analyzer",
+          {
+            "preset": "conventionalcommits",
+            "releaseRules": [
+              { "type": "perf", "release": false },
+              { "type": "docs", "release": "patch" },
+              { "type": "misc", "release": "patch" }
+            ]
+          }
+        ],
+        [
+          "@semantic-release/release-notes-generator",
+          {
+            "preset": "conventionalcommits",
+            "presetConfig": {
+              "types": [
+                {
+                  "type": "feat",
+                  "section": "Features"
+                },
+                {
+                  "type": "fix",
+                  "section": "Bug Fixes"
+                },
+                {
+                  "type": "docs",
+                  "section": "Documentation"
+                },
+                {
+                  "type": "misc",
+                  "section": "Miscellaneous"
+                }
+              ]
+            }
+          }
+        ]
+      ]
+  summary:
+    required: false
+    default: '### Released ${version} :pushpin:'
+  tag-format:
+    required: false
+    default: '${version}'
+  version:
+    required: false
+  version-bump:
+    required: false
+
+runs:
+  using: "composite"
+  steps:
+    - name: release
+      id: release
+      uses: agilecustoms/release@v1
+      with:
+        # company-specific defaults
+        aws-account: 123456789012
+        aws-region: us-east-1
+        aws-role: ${{ inputs.dev-release == 'true' && 'ci/publisher-dev' || 'ci/publisher' }}
+        aws-codeartifact-domain: mycompany
+        aws-s3-bucket: mycompany-dist
+        npm-extra-deps: conventional-changelog-conventionalcommits@9.1.0
+        # pass through inputs
+        aws-codeartifact-maven: ${{ inputs.aws-codeartifact-maven }}
+        aws-ecr: ${{ inputs.aws-ecr }}
+        dev-branch-prefix: ${{ inputs.dev-branch-prefix }}
+        dev-release: ${{ inputs.dev-release }}
+        floating-tags: ${{ inputs.floating-tags }}
+        node-version: ${{ inputs.node-version }}
+        pre-publish-script: ${{ inputs.pre-publish-script }}
+        release-channel: ${{ inputs.release-channel }}
+        release-gh: ${{ inputs.release-gh }}
+        release-plugins: ${{ inputs.release-plugins }}
+        summary: ${{ inputs.summary }}
+        tag-format: ${{ inputs.tag-format }}
+        version: ${{ inputs.version }}
+        version-bump: ${{ inputs.version-bump }}
+
+outputs:
+  version:
+    value: ${{ steps.release.outputs.version }}