# Keep docs in sync with PRs

> For the complete documentation index, see [llms.txt](https://falconer.com/docs/llms.txt).

Get notified when pull requests impact your docs. Falconer automatically detects when a merged pull request impacts your existing documentation and proposes targeted updates.


Get notified when pull requests impact your docs.

Falconer automatically detects when a merged pull request impacts your existing documentation and proposes targeted updates -- delivered straight to document owners through Slack.

> **Note:** Automatic doc updates is a new feature. Contact us at [support@falconer.com](mailto:support@falconer.com) for a demo.

To edit docs that live in a GitHub repository and push them back, see [two-way sync](https://falconer.com/docs/two-way-sync/overview.md).

## Prerequisites

Before enabling automated documentation updates, make sure you have:

- [Connected your GitHub App and Slack workspace](https://falconer.com/docs/set-up/connect-sources.md) to Falconer
- Been assigned as an owner of the documents you want to receive updates for

## How it works

When a PR merges, Falconer analyzes the code changes, identifies which documents are affected, drafts proposed updates, and notifies the right people. Owners can accept, review, or reject changes without leaving Slack.

```mermaid
flowchart LR
    PR([PR merges]) --> Notify[You get a Slack notification]
    Notify --> Accept[Accept]
    Notify --> Review[Review & edit]
    Notify --> Reject[Reject]
    Accept --> Done([Doc updated])
    Review --> Done
    Reject --> Skip([No changes])
```

## Update notifications

If a PR impacts a doc you own, you'll receive a notification in Slack.

![](/docs/images/keep-docs-in-sync-slack.png)

**Accept** -- Changes apply immediately to the document.

**Review** -- Opens the document in the Falconer editor with a **side-by-side diff** of the proposed changes. You can make manual edits before accepting or rejecting.

**Reject** -- Discards the proposed changes entirely.