# Documenter.jl does not build on tags anymore after renaming \`master\` to \`main\`

**URL:** <https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171>\
**Category:** General Usage\
**Tags:** question, documentation, documenter\
**Created:** [March 15, 2021, 5:58am UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171 "2021-03-15T05:58:06Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![ranocha](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/ranocha/32/35588_2.png) [@ranocha](https://discourse.julialang.org/u/ranocha)\
**Post date:** [March 15, 2021, 5:58am UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/1 "2021-03-15T05:58:06Z")

</div>

We tried to follow [GitHub’s new best practices and renamed `master` to `main`](https://github.com/github/renaming/) in [Trixi.jl](https://github.com/trixi-framework/Trixi.jl). We also [changed all occurrences of `master` to `main`](https://github.com/trixi-framework/Trixi.jl/pull/427), e.g. in the setup of Documenter.jl and other GitHub actions. Currently, Documenter builds fine on pushes to `main` and deploys dev docs correctly. However, Documenter is not triggered anymore when a new tag/release is created. We are still using TagBot with `DOCUMENTER_KEY` as before.  
Our current setup for [Documenter](https://github.com/trixi-framework/Trixi.jl/blob/main/.github/workflows/Documenter.yml):

```julia

name: Documentation

on:
  push:
    branches:
      - 'main'
    tags: '*'
  pull_request:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: julia-actions/setup-julia@latest
        with:
          version: '1.5'
      - name: Install dependencies
        run: julia --project=docs/ -e 'using Pkg; Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate()'
      - name: Build and deploy
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # For authentication with GitHub Actions token
          DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }} # For authentication with SSH deploy key
        run: julia --project=docs --color=yes docs/make.jl

```

Our current setup for [TagBot](https://github.com/trixi-framework/Trixi.jl/blob/main/.github/workflows/TagBot.yml):

```julia
name: TagBot
on:
  issue_comment:
    types:
      - created
  workflow_dispatch:
jobs:
  TagBot:
    if: github.event_name == 'workflow_dispatch' || github.actor == 'JuliaTagBot'
    runs-on: ubuntu-latest
    steps:
      - uses: JuliaRegistries/TagBot@v1
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          ssh: ${{ secrets.DOCUMENTER_KEY }}

```

Do you have an idea how to fix the issue and get new builds of the stable docs when a new release is tagged via TagBot?

Edit: Another slightly related question: Is there a simple way to add the dropped releases v0.3.14, v0.3.15, v0.3.16 to the `gh-pages` branch?

---

<div class="post-metadata">

**Author:** ![ranocha](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/ranocha/32/35588_2.png) [@ranocha](https://discourse.julialang.org/u/ranocha)\
**Post date:** [March 15, 2021, 8:00am UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/2 "2021-03-15T08:00:29Z")

</div>

I was able to trigger a new release build of Documenter by creating a release `v0.3.17+doc2` manually (that contains some changes compared to the previous release tagged by TagBot). I still don’t know whether Documenter will continue to work from now on… I would really like to understand what’s going on.

---

<div class="post-metadata">

**Author:** ![dilumaluthge](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/dilumaluthge/32/29283_2.png) [@dilumaluthge](https://discourse.julialang.org/u/dilumaluthge)\
**Post date:** [March 15, 2021, 11:01am UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/3 "2021-03-15T11:01:14Z")

</div>

@mortenpi

---

<div class="post-metadata">

**Author:** ![ranocha](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/ranocha/32/35588_2.png) [@ranocha](https://discourse.julialang.org/u/ranocha)\
**Post date:** [March 15, 2021, 1:21pm UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/4 "2021-03-15T13:21:45Z")

</div>

Another slightly related question: Is there a simple way to add the dropped releases v0.3.14, v0.3.15, v0.3.16 to the `gh-pages` branch?

---

<div class="post-metadata">

**Author:** ![kimikage](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kimikage/32/14534_2.png) [@kimikage](https://discourse.julialang.org/u/kimikage)\
**Post date:** [March 15, 2021, 3:29pm UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/6 "2021-03-15T15:29:10Z")

</div>

Fixing broken release deployments  
[https://juliadocs.github.io/Documenter.jl/stable/man/hosting/#Documentation-Versions](https://juliadocs.github.io/Documenter.jl/stable/man/hosting/#Documentation-Versions)

---

<div class="post-metadata">

**Author:** ![kimikage](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kimikage/32/14534_2.png) [@kimikage](https://discourse.julialang.org/u/kimikage)\
**Post date:** [March 15, 2021, 5:12pm UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/7 "2021-03-15T17:12:44Z")

</div>

Probably `[skip ci]` might be the cause.

---

<div class="post-metadata">

**Author:** ![ranocha](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/ranocha/32/35588_2.png) [@ranocha](https://discourse.julialang.org/u/ranocha)\
**Post date:** [March 15, 2021, 6:10pm UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/8 "2021-03-15T18:10:06Z")

</div>

We used that before ([set version to v0.3.13 [skip ci] · trixi-framework/Trixi.jl@af6af47 · GitHub](https://github.com/trixi-framework/Trixi.jl/commit/af6af47c0fef863dd1a3f98cd50add4afc92c4e1)) and Documenter runs on commits marked with `[skip ci]` - as far as I know, there is no switch in Documenter preventing builds for commit messages with `[skip ci]`.

---

<div class="post-metadata">

**Author:** ![kimikage](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kimikage/32/14534_2.png) [@kimikage](https://discourse.julialang.org/u/kimikage)\
**Post date:** [March 15, 2021, 6:24pm UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/9 "2021-03-15T18:24:46Z")

</div>

> **[GitHub Actions: Skip pull request and push workflows with \[skip ci\]](https://github.blog/changelog/2021-02-08-github-actions-skip-pull-request-and-push-workflows-with-skip-ci/)**
>
> GitHub Actions: Skip pull request and push workflows with \[skip ci\]

**Edit:** Please note that this announcement was made on _February 8, 2021_.

---

<div class="post-metadata">

**Author:** ![mortenpi](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mortenpi/32/158_2.png) [@mortenpi](https://discourse.julialang.org/u/mortenpi)\
**Post date:** [March 15, 2021, 9:34pm UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/10 "2021-03-15T21:34:28Z")

</div>

As far as I can tell, the tag ran and deployed fine. However, because of `[skip ci]`, the CI for the `main` branch never ran and so that’s why it did not update the docs in `dev/`.

---

<div class="post-metadata">

**Author:** ![ranocha](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/ranocha/32/35588_2.png) [@ranocha](https://discourse.julialang.org/u/ranocha)\
**Post date:** [March 16, 2021, 7:03am UTC](https://discourse.julialang.org/t/documenter-jl-does-not-build-on-tags-anymore-after-renaming-master-to-main/57171/11 "2021-03-16T07:03:35Z")

</div>

Looks like that was indeed the case. Making a new release without `[skip ci]` in the last commit message worked a few minutes ago. Thanks!