An unofficial GitHub Probot that helps reveiwing on Read the Docs
Last updated 4 months ago by eller86 .
Apache-2.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install rtd-bot 
SYNC missed versions from official npm registry.

Get URL of staging document, when you review changes.

Build Status Commitizen friendly semantic-release

Work with Read the Docs, then you'll find that PR for documentation needs additional steps like:

  • running RTD build for your branch manually, to use its result as staging site like this, or
  • sharing screenshot to share the updated document like this.

This bot automates the first approach; activate RTD build automatically when you made PR that updates docs/ directory.



To install rtd-bot to your GitHub repository, follow these interactions:

  1. Make sure that your RTD project has been connected with GitHub repository, or integrated via GitHub webhook.
  2. Invite rtd-bot user to your RTD project as maintainer.
  3. Add rtd.project config to .github/config.yml file in your repo.
  4. Enable rtd-bot in your repo from the rtd-bot page at GitHub.

Here is a sample .github/config.yml:

  project: your-read-the-docs-project

Configuration for the project with translations

If you use translations feature, make sure you've configured all your RTD projects including translations.

In .github/config.yml file, set the project slug of the root RTD project.


In Read the Docs, inviting maintainer means you give admin access to target account. So if you do not want to invite rtd-bot as maintainer, you can host this Probot app by own.

To host this bot by own, you need to set following environment variables:

  1. RTD_USERNAME that is same with user name of Read the Docs
  2. RTD_PASSWORD that is same with password of Read the Docs
  3. WEBHOOK_SECRET and APP_ID that is described at Probot document.
  4. One of PRIVATE_KEY_PATH or PRIVATE_KEY that is described at Probot document.

To run this bot on Heroku, you need to add a buildpack. See puppeteer document for detail.


Copyright © 2018-2019 Kengo TODA

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

The RTD Helper's avatar is designed by MAM2.

Current Tags

  • 0.7.3                                ...           latest (4 months ago)

18 Versions

  • 0.7.3                                ...           4 months ago
  • 0.7.2                                ...           8 months ago
  • 0.7.1                                ...           8 months ago
  • 0.7.0                                ...           9 months ago
  • 0.6.2                                ...           10 months ago
  • 0.6.1                                ...           10 months ago
  • 0.6.0                                ...           a year ago
  • 0.5.3                                ...           a year ago
  • 0.5.2                                ...           a year ago
  • 0.5.1                                ...           a year ago
  • 0.5.0                                ...           a year ago
  • 0.4.1                                ...           a year ago
  • 0.4.0                                ...           a year ago
  • 0.3.2                                ...           a year ago
  • 0.3.1                                ...           a year ago
  • 0.3.0                                ...           a year ago
  • 0.2.2                                ...           a year ago
  • 0.2.1                                ...           a year ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (13)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |