An unofficial GitHub Probot that helps reveiwing on Read the Docs
Last updated 3 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.

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.


How to use

You have three ways to use this service:

  1. Use as a SaaS
  2. Use as a step in GitHub Action
  3. Host own service

Initial setup

No matter which way you choose, follow the following interactions:

  1. Make sure that your RTD project has been connected with GitHub repository, or integrated via GitHub webhook.
  2. Add rtd.project config to the .github/config.yml file in your repo.

Here is a sample .github/config.yml:

  project: your-read-the-docs-project

1. Use as a SaaS

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, use other way instead of this way.

To enable rtd-bot SaaS for your GitHub repository, follow the following interactions:

  1. Invite rtd-bot user to your RTD project as maintainer.
  2. Enable rtd-bot in your repo from the rtd-bot page at GitHub.

2. Use as a step in GitHub Action (Not ready yet)

To use in GitHub Action, use the tag with actions- prefix. The commit includes files in lib and node_modules directories.

You need to set two environment variables: RTD_TOKEN and GITHUB_TOKEN. See the next section for detail.

  - name: Build staging document
    uses: KengoTODA/rtd-bot@actions-v0.8.4
      RTD_TOKEN: ${{ secrets.RTD_TOKEN }}
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

3. Host own service

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

  1. RTD_TOKEN, the token issued by Read the Docs. See official doc for detail.
  2. WEBHOOK_SECRET and APP_ID that is described at Probot document.
  3. One of PRIVATE_KEY_PATH or PRIVATE_KEY that is described at Probot document.

Advanced Configuration

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.


Copyright © 2018-2020 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

  • 1.0.2                                ...           latest (3 months ago)

23 Versions

  • 1.0.2                                ...           3 months ago
  • 1.0.1                                ...           3 months ago
  • 1.0.0                                ...           3 months ago
  • 0.8.3                                ...           4 months ago
  • 0.8.2                                ...           4 months ago
  • 0.7.3                                ...           a year ago
  • 0.7.2                                ...           a year ago
  • 0.7.1                                ...           a year ago
  • 0.7.0                                ...           a year ago
  • 0.6.2                                ...           a year ago
  • 0.6.1                                ...           a year ago
  • 0.6.0                                ...           2 years ago
  • 0.5.3                                ...           2 years ago
  • 0.5.2                                ...           2 years ago
  • 0.5.1                                ...           2 years ago
  • 0.5.0                                ...           2 years ago
  • 0.4.1                                ...           2 years ago
  • 0.4.0                                ...           2 years ago
  • 0.3.2                                ...           2 years ago
  • 0.3.1                                ...           2 years ago
  • 0.3.0                                ...           2 years ago
  • 0.2.2                                ...           2 years ago
  • 0.2.1                                ...           2 years ago
Maintainers (1)
Today 0
This Week 1
This Month 1
Last Day 1
Last Week 0
Last Month 3
Dependencies (5)
Dev Dependencies (12)
Dependents (0)

Copyright 2014 - 2017 © taobao.org |