ci-workflows

---

Common Continuous Integration (CI) workflows and setup for go-openapi repos.

• shared github action workflows
• shared dependabot configuration (BLOCKED)
• shared golangci-lint configuration (BLOCKED)

Status

Unreleased.

Initial setup. Content may evolve with breaking changes.

NOTE: at this moment, it is difficult to share the dependabot and golangci-lint configurations, so these are not shared yet.

Basic usage

Motivation

It took a while (well a something like 10 years...), but we eventually managed to align all checks, tests and 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.

Contemplated enhancements

In no particular order:

• ui: enrich github actions UI with a job summary
• doc: add markdown linting for docs
• doc: add spellcheck for docs (and code?)
• introduce config file specific checkout (markdownlint, spellcheck)
• 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
• 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)
• dependencies: manage somehow to share / replicate dependabot config
• lint: golangci-lint: check valid PR comments etc
• lint: use non-blocking, scheduled, proactive full linting to check for the impact of new linters, new go versions etc
• doc: (possibility) take over hugo & doc gen part from go-swagger
• (possibility) take over release part from go-swagger
• doc: produce hugo github page with all latest tagged versions (incl. mono repo)
• add bot to filter PRs, issues
• check with github API that all repo settings (branch protection rules, etc) 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)
• 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)

Change log

See https://github.com/go-openapi/ci-workflows/releases

Licensing

This content ships under the SPDX-License-Identifier: Apache-2.0.

Other documentation

• All-time contributors
• Contributing guidelines
• Maintainers documentation
• Code style