Skip to content

Conversation

@jbj
Copy link
Contributor

@jbj jbj commented Sep 12, 2025

Internal reference: codeql-team ADR 0011.

We can now change QL libraries without a 1-year deprecation period, allowing the libraries to converge more quickly toward greater usability. However,

  • We'll continue to write change notes for breaking changes.
  • We'll continue to bump the major version of QL packs when there are breaking changes, so downstream code should only need updating if they depend on the latest version.
  • We'll continue to be mindful of the burden we place on library consumers, both those inside and outside GitHub.

jbj added 2 commits September 12, 2025 09:24
Internal reference: codeql-team ADR 0011.
The change notes are now maintained under each query pack, so there's no
single place where we can link to it.
Copilot AI review requested due to automatic review settings September 12, 2025 07:40
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR removes the 1-year deprecation period requirement for QL libraries while maintaining it for queries, aligning with internal ADR 0011 to allow faster convergence toward more usable libraries.

  • Removes the 1-year deprecation period requirement for QL libraries
  • Maintains the deprecation period requirement for queries only
  • Updates documentation to clarify the distinction between queries and libraries

@jbj jbj merged commit eac8a79 into github:main Sep 16, 2025
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants