Skip to content

chore: add LLVM version support policy #87

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
shenxianpeng wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

chore: add LLVM version support policy #87

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
50f4926
chore: add LLVM version support policy document
shenxianpeng Jun 14, 2026
dc80c6e
Update docs
shenxianpeng Jun 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions VERSION_SUPPORT_POLICY.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Version Alignment Policy

> **Disclaimer:** cpp-linter does **not** develop or maintain LLVM / Clang tools. We only
> pre-build and repackage upstream LLVM releases for easier installation. We do **not** fix
> bugs, add features, or backport patches to any LLVM version — those are the responsibility
> of the [LLVM project](https://github.com/llvm/llvm-project).

We provide pre-built static binaries, Docker images, and Python wheels for **LLVM 11 through
the latest stable release**. The latest 3 major versions receive full CI testing coverage.

Older versions may be dropped over time as they become difficult to build on current platforms.
Version-specific issues in dropped versions will be closed as `wontfix`.

---

## FAQ

**Q: Do you fix bugs in clang-tidy or clang-format?**

No. Please report tool bugs to the [LLVM project](https://github.com/llvm/llvm-project/issues).
If a download is broken or a binary is missing, report that to us.

**Q: Which default version does `cpp-linter-action` use?**

Currently **LLVM 20** (the middle of the latest 3 major versions).

**Q: Need a version we no longer package?**

You can fork our build repositories and build it yourself. Start a
[discussion](https://github.com/orgs/cpp-linter/discussions) if you think others need it too.
13 changes: 10 additions & 3 deletions profile/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,14 @@

## 📖 About

**cpp-linter** bundles the power of `clang-format`, `clang-tidy`, and other LLVM tools into packages that are easy to install, integrate, and maintain. Whether you’re linting a single file locally or enforcing code quality across dozens of repos in CI, cpp-linter has you covered.
**cpp-linter** repackages upstream `clang-format`, `clang-tidy`, and other LLVM tools into
ready-to-use packages (static binaries, Docker images, Python wheels) — making them easy to
install and integrate without building from source. Whether you’re linting a single file locally
or enforcing code quality across dozens of repos in CI, cpp-linter has you covered.

> **We do not develop or maintain the clang tools themselves.** cpp-linter is a redistribution
> layer: we pre-build and publish upstream LLVM releases. For tool bugs, features, or behavioral
> issues, please report to the [LLVM project](https://github.com/llvm/llvm-project).

We target C/C++ developers and DevOps engineers who want **reliable clang tooling without the build-from-source headache**.

Expand All @@ -33,9 +40,9 @@ Integrate cpp-linter into your workflow in minutes:

---

## 🔧 Clang Tools — Simplified
## 🔧 Clang Tools — Pre-packaged

We provide ready-to-use **binaries**, **Docker images**, and **Python wheels** of key clang tools:
We pre-build and publish ready-to-use **binaries**, **Docker images**, and **Python wheels** of upstream clang tools:

| Package | Description |
|---------|-------------|
Expand Down