allow to specify a git branch

[certik]

For testing purposes, it'd be cool to just use a "docs" branch, or some other branch of git. Otherwise I always need to push into the master, just to test some idea out, to make sure things build at readthedocs.org

[ericholscher]

This should be working now. In the edit project dialog you should be able to specify a default branch.

[pfalcon]

In the edit project dialog you should be able to specify a default branch.

Fast forward 5 years, there's neither "project edit dialog" nor ability to specify a branch.

[agjohnson]

@pfalcon

[pfalcon]

@agjohnson : I see, thanks. For slow folks like me, who can't get it right away: You need to go to your project, click "Admin" button, then "Versions" in left navbar. Then you will be shown a list of tags, and most importantly, branches of your git repo. All branches are by default unselected. You need to click "Active" checkbox by the branches you want to build docs from, and then Submit button. After that, you will be able to see those branches in list of "versions" throughout readthedocs UI, and build from them.

[nad2000]

Using "Version" tab I can see that "latest" is mapped to a branch (git):

But how it could be mapped to a different branch? While I was testing I was using this specific branch. Now I need to map it to master. Hitting edit or going via Admin->Versions... didn't help either.

[stsewd]

@nad2000 you need to do this in the Admin section, Advanced settings -> Default branch

[rayluo]

Leaving a mark here to help future readers. If the solution mentioned above by @pfalcon would NOT work for you, you should double check:

• the Integrations setting in your project inside ReadTheDocs
• and/or the webhooks in your repo's hoster, such as Github

In my case, somehow the integration has been broken for quite a while, so RTD can not pick up the new branch that I've pushed into my repo. My workaround is to delete the old integration, and create a new one.