{"action":"created","issue":{"url":"https://api.github.com/repos/open-contracting/standard-development-handbook/issues/3","repository_url":"https://api.github.com/repos/open-contracting/standard-development-handbook","labels_url":"https://api.github.com/repos/open-contracting/standard-development-handbook/issues/3/labels{/name}","comments_url":"https://api.github.com/repos/open-contracting/standard-development-handbook/issues/3/comments","events_url":"https://api.github.com/repos/open-contracting/standard-development-handbook/issues/3/events","html_url":"https://github.com/open-contracting/standard-development-handbook/issues/3","id":249706403,"number":3,"title":"GitHub: Branch management (+cleanup)","user":{"login":"jpmckinney","id":26463,"avatar_url":"https://avatars1.githubusercontent.com/u/26463?v=4","gravatar_id":"","url":"https://api.github.com/users/jpmckinney","html_url":"https://github.com/jpmckinney","followers_url":"https://api.github.com/users/jpmckinney/followers","following_url":"https://api.github.com/users/jpmckinney/following{/other_user}","gists_url":"https://api.github.com/users/jpmckinney/gists{/gist_id}","starred_url":"https://api.github.com/users/jpmckinney/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jpmckinney/subscriptions","organizations_url":"https://api.github.com/users/jpmckinney/orgs","repos_url":"https://api.github.com/users/jpmckinney/repos","events_url":"https://api.github.com/users/jpmckinney/events{/privacy}","received_events_url":"https://api.github.com/users/jpmckinney/received_events","type":"User","site_admin":false},"labels":[{"id":668745566,"url":"https://api.github.com/repos/open-contracting/standard-development-handbook/labels/GitHub","name":"GitHub","color":"fef2c0","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":2,"created_at":"2017-08-11T18:00:32Z","updated_at":"2017-08-22T10:39:47Z","closed_at":null,"body":"Repositories should have only a default branch (usually `master`) and pull request branches. The default branch should be [protected](https://help.github.com/articles/about-protected-branches/) with these options:\r\n\r\n* ☑️ Protect this branch\r\n  * ☑️ Require status checks to pass before merging\r\n    * ☑️ Require branches to be up to date before merging\r\n    * ☑️ continuous-integration/travis-ci (if available)\r\n  * ☑️ Include administrators\r\n\r\n# Management\r\n\r\n* If a branch has no commits ahead of the default branch, and is merged, delete it.\r\n* If a branch has no commits ahead of the default branch, and is not merged but is a month old, delete it.\r\n\r\n## Expected non-default branches\r\n\r\n* [json-schema-random](https://github.com/open-contracting/json-schema-random) is a [fork](https://github.com/andreineculau/json-schema-random), with an [`opencontracting` branch](https://github.com/open-contracting/json-schema-random/branches) for our changes. **I changed the default branch to `opencontracting`.**\r\n\r\n## Unexpected non-default branches\r\n\r\nThese should either be deleted, opened as pull requests, or documented and protected. I've tagged the people who opened the branches.\r\n\r\n### Unmerged branches\r\n\r\n* [ ] https://github.com/open-contracting/api-specification/branches @timgdavies \r\n* [ ] https://github.com/open-contracting/ocds-show-ppp/branches @kindly I'm not sure why the repository has both `master` and `gh-pages` branches. GitHub only requires one branch for GitHub Pages.\r\n* [ ] https://github.com/open-contracting/ocds_lots_extension/branches @kindly \r\n* [ ] https://github.com/open-contracting/standard_theme/branches @Bjwebb @kindly I assume we keep the `master` branch as a reference to the upstream repository.\r\n\r\n### Unmerged or merged branches with commits ahead of default branch\r\n\r\n* [ ] https://github.com/open-contracting/public-private-partnerships/branches @duncandewhurst I don't know the significance of the version number branches.\r\n* [ ] https://github.com/open-contracting/extension_registry/branches @timgdavies @duncandewhurst  I don't know the significance of the version number branches. It also has a `gh-pages` branch that is behind the default branch. I suspect this used to be deployed with GitHub Pages, but this changed, without deleting the old `gh-pages` branch. **Can we delete the `gh-pages` branch?**\r\n* [ ] https://github.com/open-contracting/ocds-show/branches @robredpath @timgdavies @kindly It also has a `master` branch which is up-to-date with the default `gh-pages` branch. **Can we delete the `master` branch?**\r\n* [ ] https://github.com/open-contracting/standard/branches/all @Bjwebb @duncandewhurst @timgdavies @kindly It has the most branches. The version number branches seem to be [documented](http://standard.open-contracting.org/latest/en/support/governance/#versions).\r\n  * At what point do we delete `*-dev` branches? If never, we should protect those branches.\r\n  * Why are there not `x.x` branches for all versions? Not all prior versions are built at [standard.open-contracting.org](http://standard.open-contracting.org). If we need these branches forever, we should protect them."},"comment":{"url":"https://api.github.com/repos/open-contracting/standard-development-handbook/issues/comments/323988456","html_url":"https://github.com/open-contracting/standard-development-handbook/issues/3#issuecomment-323988456","issue_url":"https://api.github.com/repos/open-contracting/standard-development-handbook/issues/3","id":323988456,"user":{"login":"Bjwebb","id":634,"avatar_url":"https://avatars0.githubusercontent.com/u/634?v=4","gravatar_id":"","url":"https://api.github.com/users/Bjwebb","html_url":"https://github.com/Bjwebb","followers_url":"https://api.github.com/users/Bjwebb/followers","following_url":"https://api.github.com/users/Bjwebb/following{/other_user}","gists_url":"https://api.github.com/users/Bjwebb/gists{/gist_id}","starred_url":"https://api.github.com/users/Bjwebb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Bjwebb/subscriptions","organizations_url":"https://api.github.com/users/Bjwebb/orgs","repos_url":"https://api.github.com/users/Bjwebb/repos","events_url":"https://api.github.com/users/Bjwebb/events{/privacy}","received_events_url":"https://api.github.com/users/Bjwebb/received_events","type":"User","site_admin":false},"created_at":"2017-08-22T10:39:47Z","updated_at":"2017-08-22T10:39:47Z","body":">  https://github.com/open-contracting/standard_theme/branches @Bjwebb @kindly I assume we keep the master branch as a reference to the upstream repository.\r\n\r\nThat's right. I think this is the same case as json-schema-random\r\n\r\n> At what point do we delete *-dev branches? If never, we should protect those branches.\r\n\r\nNever.\r\n\r\n> Why are there not x.x branches for all versions? Not all prior versions are built at standard.open-contracting.org. If we need these branches forever, we should protect them.\r\n\r\nVersions prior to 1.0 were built from tags rather than branches. Are those what you're asking about?\r\n"}}
{"actor":{"display_login":"Bjwebb"}}