Let users know when documentation gets better
Better documentation is a product improvement when it removes friction for users.
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
Create Post
Creates a new post on a facebook page.
Why this helps
Documentation work improves the experience but rarely gets the visibility it deserves.
- Give documentation work a public signal
- Help users discover new guidance
- Connect maintenance work to customer value
- Reduce the need to remember educational posts
Setup
Build it in a few focused steps.
- 1Connect GitHub and Facebook to Notis once through the portal.
- 2Create an automation or ask Notis to announce meaningful README changes as user-focused Facebook updates.
- 3Pick the GitHub README changed trigger and choose a channel for run reports.
- 4Test with one real README update and confirm that technical noise is removed.
Questions about this workflow
Can it ignore spelling fixes?
Yes. Tell Notis to post only changes that improve setup, usage, or understanding.
Can it include the documentation link?
Yes. Ask it to include the relevant public repository or documentation link.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link GitHub to Facebook. A trigger fires from one place; an action lands in another.
GitHub triggers
Facebook actions
Recurring trigger
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
Add Photos to Album
Adds photos to an existing facebook album. note: currently adds one photo at a time. for true batch upload, use facebook's batch api endpoint directly.
Webhook trigger
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Add Reaction
Adds a specific reaction (like, love, wow, etc.) to a facebook post or comment.
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.
Assign Page Task
Assigns tasks/roles to a user for a specific facebook page.
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.
Create Comment
Creates a comment on a facebook post or replies to an existing comment.
New Branch Created
Triggers when a new branch is created in a GitHub repository. Detects newly created branches. Deleted branches do not fire events.
Create Photo Album
Creates a new photo album on a facebook page.
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.
Create Photo Post
Creates a photo post on a facebook page.
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.
Create Post
Creates a new post on a facebook page.
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.
Create Video Post
Creates a video post on a facebook page.
Connect any two apps with Notis in the middle.
GitHub and Facebook, or any other combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7-day trial of any paid plan, with 20$ of usage included.
No card. Works with personal or business Facebook.