Webhooks are pretty amazing, and help to turn the web into a push instead of pull platform. We have support for hitting a URL whenever you commit to your project and we will try and rebuild your docs. This only rebuilds them if something has changed, so it is cheap on the server side. As anyone who has worked with push knows, pushing a doc update to your repo and watching it get updated within seconds is an awesome feeling.
If your project is hosted on GitHub, you can easily add a hook that will rebuild your docs whenever you push updates:
- Go to the “Settings” page for your project
- Click “Webhooks & Services”
- In the “Services” section, click “Add service”
- In the list of available services, click “ReadTheDocs”
- Check “Active”
- Click “Add service”
Note: The GitHub URL in your Read the Docs project must match the URL on GitHub. The URL is case-sensitive.
If your project is hosted on Bitbucket, you can easily add a hook that will rebuild your docs whenever you push updates:
- Go to the “admin” page for your project
- Click “Hooks”
- In the available service hooks, select “Read the Docs”
- Click “Add hook”
Your ReadTheDocs project detail page has your post-commit hook on it; it will
look something along the lines of
Regardless of which revision control system you use, you can just hit this URL
to kick off a rebuild.