Skip to content

ci: add centralized docs drift check - #1212

Merged
kavirajk merged 1 commit into
mainfrom
joe/docs-drift-check
Oct 21, 2026
Merged

kavirajk merged 1 commit into
mainfrom
joe/docs-drift-check

Conversation

@joe-clickhouse

Copy link
Copy Markdown
Contributor

Summary

Adds the shared docs-drift check already used by clickhouse-connect, dbt-clickhouse, and clickhouse-go. It reviews PR changes against this repo's docs and maintains an advisory needs-docs label and one sticky comment. A later docs fix clears the label and marks the comment resolved.

The custom agent definition is a solid first attempt based on the repo's current docs and public APIs. It covers the README, public Go docs, and documented examples for the client, pool, block streaming, query parameters, column types, Native dumps, compression, authentication, and telemetry. The website comparison in clickhouse-go stays outside this checker's scope. We can update or change the definition at any time, before or after this PR merges.

This repo needs access to the shared Workflow Authentication App and the WORKFLOW_AUTH_PUBLIC_APP_ID and WORKFLOW_AUTH_PUBLIC_PRIVATE_KEY secrets before the check can run.

Automatic checks skip fork and Dependabot PRs. Maintainers can check reviewed PRs manually. The worker reads the agent definition from the trusted PR base, so this will start taking effect after merge.

@kavirajk kavirajk left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM. thanks @joe-clickhouse

@kavirajk
kavirajk merged commit 83e4b3d into main Oct 21, 2026
18 checks passed
@kavirajk
kavirajk deleted the joe/docs-drift-check branch October 21, 2026 08:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants