Development tips

Enable publishing with GitHub Actions in new repositories¶

By default, GitHub disables write privileges in any repository in the jupyter-book organization. This prevents repositories from being able to publish new releases from GitHub Actions.

To enable write access in GitHub Actions, add the following to the relevant GitHub Action in the repository.

permissions:
  contents: write
  pull-requests: write

For more information, see the GitHub Actions documentation.

For examples of this pattern in use in the Jupyter Book organization, see this GitHub search query of using this configuration.