Skip to content

Include per rule documentation website links to github commentsΒ #717

@ikavalio

Description

@ikavalio

Hello!

https://squawkhq.com/docs is such an incredible source of information, I wonder if it makes sense to include direct links to violated rule documentation under https://squawkhq.com/docs to github comments? When users are new to squawk and postgres migrations, it takes a little bit of time to discover rule documentation website if you see a github comment for the first time.

To be fair squawk comment has plenty of data and a few external urls, but none of them have as much detail as https://squawkhq.com/docs or point directly to documentation website:

I don't know if it's a good idea, but a new Rule Documentation block after Rule Violations

<h3><code>{filename}</code></h3>
```sql
{sql}
```{truncation_notice}
<h4>{violations_emoji} Rule Violations ({violation_count})</h4>
{violation_content}
---
",
violations_emoji = violations_emoji,
filename = violation.filename,
sql = display_sql,
truncation_notice = truncation_notice,
violation_count = violation_count,
violation_content = violation_content
))
}
that lists all unique violated rules and points to documentation website could work? (or just a single block at the end of the comment with unique links across all files)

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions