wrapped up working vs experimental

Signed-off-by: Frederic BIDON <fredbi@yahoo.com>

Author: fredbi

README.md

@@ -8,8 +8,7 @@
 [![Release][release-badge]][release-url] [![Go Report Card][gocard-badge]][gocard-url] [![CodeFactor Grade][codefactor-badge]][codefactor-url] [![License][license-badge]][license-url]
 <!-- Badges: documentation & support -->
 <!-- Badges: others & stats -->
-<!-- Slack badge disabled until I am able to restore a valid link to the chat -->
-[![GoDoc][godoc-badge]][godoc-url] <!-- [![Slack Channel][slack-badge]][slack-url] -->[![go version][goversion-badge]][goversion-url] ![Top language][top-badge] ![Commits since latest release][commits-badge]
+[![GoDoc][godoc-badge]][godoc-url] [![Slack Channel][slack-logo]![slack-badge]][slack-url] [![go version][goversion-badge]][goversion-url] ![Top language][top-badge] ![Commits since latest release][commits-badge]
 
 ---
 
@@ -36,18 +35,16 @@ It took a while (well a something like 10 years...), but we eventually managed t
 dependabot rules declared in the family of go-openapi repos.
 
 Now we'd like to be able to maintain, enrich and improve these checks without
-worrying too much about the burden of replicating it about a dozen times.
+worrying too much about the burden of replicating the stuff about a dozen times.
 
 ## Contemplated enhancements
 
 In no particular order:
 
 * [x] ui: enrich github actions UI with a job summary
-* [x] doc: add markdown linting for docs
-* [x] doc: add spellcheck for docs (and code?)
 * [x] introduce config file specific checkout (markdownlint, spellcheck)
 * [x] security: separate PR / issue comments as a trusted bot workflow, acting on request artifacts
-* [ ] version common workflows, so we can limit the impact of a change
+* [x] version common workflows, so we can limit the impact of a change
 * [ ] build: verify that go.sum cache for tests works (should be enabled)
 * [ ] share mono repo workflows (see github.com/go-openapi/swag/.github/workflows)
 * [ ] lint: manage somehow to share golangci config (with local merge)
@@ -64,11 +61,15 @@ In no particular order:
       are identical
 * [ ] comment PRs and issues
 * [ ] doc: checkout vale style-check guide (vale-action exists)
-* [ ] doc: experiment LanguageTool for grammar checks ( -> a github action / docker image exists)
+* [x] ~doc: experiment LanguageTool for grammar checks ( -> a github action / docker image exists)~
 * [ ] doc: experiment LLM from github model, using embeddings ( -> 
 * [ ] issues: experiment LLM from github model, using embeddings ( -> show related issues)
 * [ ] github pages w/ hugo (like go-swagger, experiment another theme and json data)
 
+To be reworked:
+* [ ] doc: add markdown linting for docs
+* [ ] doc: add spellcheck for docs (and code?)
+
 ## Change log
 
 See <https://github.com/go-openapi/ci-workflows/releases>
@@ -88,6 +89,15 @@ This content ships under the [SPDX-License-Identifier: Apache-2.0](./LICENSE).
 * [Maintainers documentation](docs/MAINTAINERS.md)
 * [Code style](docs/STYLE.md)
 
+## Cutting a new release
+
+Maintainers can cut a new release by either:
+
+* running [this workflow](https://github.com/go-openapi/gh-actions/actions/workflows/local-bump-release.yml)
+* or pushing a semver tag
+  * signed tags are preferred
+  * The tag message is prepended to release notes
+
 <!-- Badges: status  -->
 [test-badge]: https://github.com/go-openapi/ci-workflows/actions/workflows/go-test.yml/badge.svg
 [test-url]: https://github.com/go-openapi/ci-workflows/actions/workflows/go-test.yml
@@ -112,8 +122,9 @@ This content ships under the [SPDX-License-Identifier: Apache-2.0](./LICENSE).
 [doc-url]: https://goswagger.io/go-openapi
 [godoc-badge]: https://pkg.go.dev/badge/github.com/go-openapi/ci-workflows
 [godoc-url]: http://pkg.go.dev/github.com/go-openapi/ci-workflows
-[slack-badge]: https://slackin.goswagger.io/badge.svg
-[slack-url]: https://slackin.goswagger.io
+[slack-logo]: https://a.slack-edge.com/e6a93c1/img/icons/favicon-32.png
+[slack-badge]: https://img.shields.io/badge/slack-blue?link=https%3A%2F%2Fgoswagger.slack.com%2Farchives%2FC04R30YM
+[slack-url]: https://goswagger.slack.com/archives/C04R30YMU
 <!-- Badges: license & compliance -->
 [license-badge]: http://img.shields.io/badge/license-Apache%20v2-orange.svg
 [license-url]: https://github.com/go-openapi/ci-workflows/?tab=Apache-2.0-1-ov-file#readme

doc-templates/README.md

@@ -8,8 +8,7 @@
 [![Release][release-badge]][release-url] [![Go Report Card][gocard-badge]][gocard-url] [![CodeFactor Grade][codefactor-badge]][codefactor-url] [![License][license-badge]][license-url]
 <!-- Badges: documentation & support -->
 <!-- Badges: others & stats -->
-<!-- Slack badge disabled until I am able to restore a valid link to the chat -->
-[![GoDoc][godoc-badge]][godoc-url] <!-- [![Slack Channel][slack-badge]][slack-url] -->[![go version][goversion-badge]][goversion-url] ![Top language][top-badge] ![Commits since latest release][commits-badge]
+[![GoDoc][godoc-badge]][godoc-url] [![Slack Channel][slack-logo]![slack-badge]][slack-url] [![go version][goversion-badge]][goversion-url] ![Top language][top-badge] ![Commits since latest release][commits-badge]
 
 ---
 
@@ -55,6 +54,15 @@ on top of which it has been built.
 * [Maintainers documentation](docs/MAINTAINERS.md)
 * [Code style](docs/STYLE.md)
 
+## Cutting a new release
+
+Maintainers can cut a new release by either:
+
+* running [this workflow](https://github.com/{{ .Owner }}/{{ .Repo }}/actions/workflows/bump-release.yml)
+* or pushing a semver tag
+  * signed tags are preferred
+  * The tag message is prepended to release notes
+
 <!-- Badges: status  -->
 [test-badge]: https://github.com/{{ .Owner }}/{{ .Repo }}/actions/workflows/go-test.yml/badge.svg
 [test-url]: https://github.com/{{ .Owner }}/{{ .Repo }}/actions/workflows/go-test.yml

experimental/go-test-monorepo.yml

@@ -44,23 +44,24 @@ jobs:
         with:
           version: latest
           skip-cache: true
-          install-only: true
-      -
-        name: Lint multiple modules
-        if: ${{ steps.detect-monorepo.outputs == 'true' }}
-        # golangci-lint doesn't support go.work to lint multiple modules in one single pass
-        # TODO: golangci-action v9.1+ has a built-in mono repo detection setup.
-        run: |
-          set -euxo pipefail
+          #install-only: true
+          experimental: "automatic-module-directories"
+      #-
+      #  name: Lint multiple modules
+      #  if: ${{ steps.detect-monorepo.outputs == 'true' }}
+      #  # golangci-lint doesn't support go.work to lint multiple modules in one single pass
+      #  # TODO: golangci-action v9.1+ has a built-in mono repo detection setup.
+      #  run: |
+      #    set -euxo pipefail
 
-          git fetch origin master
-          git show --no-patch --oneline origin/master
+      #    git fetch origin master
+      #    git show --no-patch --oneline origin/master
 
-          while read -r module_location ; do
-            pushd "${module_location}"
-            golangci-lint run --new-from-rev origin/master
-            popd
-          done < <(go list -f '{{.Dir}}' -m)
+      #    while read -r module_location ; do
+      #      pushd "${module_location}"
+      #      golangci-lint run --new-from-rev origin/master
+      #      popd
+      #    done < <(go list -f '{{.Dir}}' -m)
 
   test:
     name: Unit tests mono-repo
@@ -162,6 +163,7 @@ jobs:
           retention-days: 1
 
   fuzz-test:
+    # fuzz-test supports go monorepos
     uses: ./.github/workflows/fuzz-test.yml
 
   test-complete: