Keep README visuals accessible as docs evolve
Documentation changes deserve the same accessibility attention as product changes.
Trigger
GitHub Repository README Changed
Triggers when the README file in a specific repository directory changes. Monitors the README in a configurable directory and branch/tag/commit. The payload includes the current README metadata (filename, path, SHA, size, URLs), the previous and current git blob SHAs, and a list of which tracked fields changed.
Action
Get Images
Tool to retrieve a paginated list of images in your library, including their alt text and metadata. use when you need to browse or filter images programmatically after authentication.
Why this helps
README screenshots and diagrams often change outside the main product review flow.
- Catches changed documentation visuals
- Reduces separate documentation audits
- Keeps onboarding assets easier to use
- Supports accessible open source communication
Setup
Build it in a few focused steps.
- 1Connect GitHub and Alttext ai to Notis once through the portal.
- 2Create the automation in Automations -> New Automation or ask Notis to create it.
- 3Use this instruction: When the GitHub README changes, retrieve matching images from Alttext ai and report any documentation visuals that need alt text or metadata review.
- 4Select GitHub Repository README Changed as the trigger and pick a report channel.
- 5Test by updating one README image or screenshot.
Questions about this workflow
Is this only for the root README?
Configure the GitHub README trigger for the repository directory and reference you need.
Can it review screenshots?
Yes. Ask Notis to focus its Alttext ai search on screenshots and other documentation visuals.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link GitHub to Alttext ai. A trigger fires from one place; an action lands in another.
GitHub triggers
Alttext ai actions
New Workflow Artifact Created
Triggers when a new workflow artifact is created in a GitHub repository. Monitors for newly created GitHub Actions workflow artifacts. Optionally filters by artifact name to restrict monitoring to specific artifacts.
Get Account
Tool to retrieve account settings and usage information. use when you need to check your alttext.ai account configuration and usage limits before generating alt text.
Branch Changed
Triggers when a GitHub branch changes. Monitors a specific branch for: - New commits pushed (head commit SHA changes) - Protection status toggled (branch becomes protected or unprotected) - Protection settings changed, including: required status checks and their enforcement level, admin enforcement, required pull request reviews (dismiss stale reviews, code owner reviews, approving review count, last push approval), required linear history, force push allowance, deletion allowance, conversation resolution, branch locking, and fork syncing.
Get Account
Tool to retrieve account settings and usage information. use when you need to check your alttext.ai account configuration and usage limits before generating alt text.
New Branch Created
Triggers when a new branch is created in a GitHub repository. Detects newly created branches. Deleted branches do not fire events.
Get Images
Tool to retrieve a paginated list of images in your library, including their alt text and metadata. use when you need to browse or filter images programmatically after authentication.
Check Run Status / Conclusion Changed
Triggers when a specific GitHub check run changes its status or conclusion. Monitors a single check run for changes to: status (queued, in_progress, completed, etc.), conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required), started_at, and completed_at.
Search Images
Tool to search for images and their alt text. use after specifying search keywords to retrieve matching images.
Check Suite Status / Conclusion Changed
Triggers when a GitHub check suite changes its status or conclusion for a given ref. Monitors all check suites associated with a git reference (branch, tag, or commit SHA) for changes to status (queued, in_progress, completed, etc.) and conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required, startup_failure, stale). Optionally filters by GitHub App ID.
Update Account
Tool to update account settings (e.g., webhook url, name). use after confirming current account details to modify settings.
New Code Scanning Alert Created
Triggers when a new code scanning alert is created in a repository. Fires an event for each newly created code scanning alert detected in the configured repository. Alerts can be filtered by Git reference, scanning tool, state, and severity. The payload includes the alert number, rule details, tool information, state, severity, and the location of the most recent instance.
New Repository Collaborator Added
Triggers when a new collaborator is added to a GitHub repository. Monitors the full list of collaborators on a repository and fires an event for each newly added collaborator. The payload includes the collaborator's GitHub username, account ID, profile URL, avatar URL, permission flags (pull, triage, push, maintain, admin), and assigned role name.
Commit Event
Triggered when a new commit is pushed to a repository.
Connect any two apps with Notis in the middle.
Not just GitHub and Alttext ai. Any combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7 days free trial with 20$ free usage included.
No card. Works with personal or business Alttext ai.