Skip to content

tighten advisor copy for pg_graphql and secdef lints#161

Merged
dnywh merged 4 commits into
mainfrom
dnywh/pg-graphql-lint-copy
Apr 27, 2026
Merged

tighten advisor copy for pg_graphql and secdef lints#161
dnywh merged 4 commits into
mainfrom
dnywh/pg-graphql-lint-copy

Conversation

@dnywh
Copy link
Copy Markdown
Contributor

@dnywh dnywh commented Apr 27, 2026

Summary

Tightens the user-facing copy for the four pg_graphql / SECURITY DEFINER security lints added in #158 and #160.

This keeps the lint logic the same and focuses on making the titles, issue text, and top-level docs copy easier to act on.

What changed

  • rewrote the titles to lead with the user-facing risk rather than the implementation detail
  • rewrote the SQL description and detail copy to be more direct and action-oriented
  • tightened the Summary and Ramification sections in the matching docs pages
  • regenerated splinter.sql

Comment thread mkdocs.yaml
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Adds these new lints to the sidebar/nav.

Comment on lines +35 to +39
**Copy guidance for Advisor surfaces:**
- Keep `description` to 1-2 short sentences: what the lint detects and the first likely action.
- Keep `detail` concise and object-specific. It should describe the failing object, not restate the full rationale.
- Put deeper explanation, edge cases, and extended remediation in `docs/XXXX_<name>.md`, not in the SQL strings.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

For future lints. Helps make the Advisor side on Studio easier to read (and lints for consistent).

@dnywh dnywh merged commit 55db5b1 into main Apr 27, 2026
2 checks passed
@dnywh dnywh deleted the dnywh/pg-graphql-lint-copy branch April 27, 2026 02:38
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