Check baseline boolean options

[QuintinWillison]

The things that should:

• not be contentious - in that they reflect the way that we, as an org, use GitHub
• have been set when the repository was created, generally remaining static from thereon

Taking a quick look using GitHub's GraphQL API Explorer, this query represents a good starting set:

{
  organization(login: "ably") {
    repositories(first: 10, privacy: PUBLIC) {
      nodes {
        name
        deleteBranchOnMerge
        hasIssuesEnabled
        hasProjectsEnabled
        hasWikiEnabled
        rebaseMergeAllowed
        squashMergeAllowed
        mergeCommitAllowed
        isArchived
        isDisabled
        isLocked
        isBlankIssuesEnabled
        forkingAllowed
      }
    }
  }
}

In the example above I've intentionally set first to 10 and privacy to PUBLIC, for illustrative purposes, so I can feel free to share the result:

{
  "data": {
    "organization": {
      "repositories": {
        "nodes": [
          {
            "name": "ably-js",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          },
          {
            "name": "ably-common",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          },
          {
            "name": "docs",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          },
          {
            "name": "ably-php",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          },
          {
            "name": "ably-ruby",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          },
          {
            "name": "ably-ruby-rest",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          },
          {
            "name": "ably-java",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          },
          {
            "name": "ably-dotnet",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          },
          {
            "name": "ably-go",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          },
          {
            "name": "ably-cocoa",
            "deleteBranchOnMerge": true,
            "hasIssuesEnabled": true,
            "hasProjectsEnabled": false,
            "hasWikiEnabled": false,
            "rebaseMergeAllowed": false,
            "squashMergeAllowed": false,
            "mergeCommitAllowed": true,
            "isArchived": false,
            "isDisabled": false,
            "isLocked": false,
            "isBlankIssuesEnabled": true,
            "forkingAllowed": true
          }
        ]
      }
    }
  }
}

[QuintinWillison]

Looking at the starting set in my opening comment, I think there are probably a few logical groupings of checks here:

• 'Features':
  • hasIssuesEnabled: true GitHub UI: 'Issues' 'Issues integrate lightweight task tracking into your repository. Keep projects on track with issue labels and milestones, and reference them in commit messages.'
  • hasProjectsEnabled: false GitHub UI: 'Projects' Should be disabled at org-level, but still correct to check at repository-level.
  • hasWikiEnabled: false GitHub UI: 'Wikis'
  • forkingAllowed: true if public, false if private 'Allow forking' (only displays in options for private repositories)
• 'Merge button':
  • deleteBranchOnMerge: true GitHub UI: 'Automatically delete head branches'
  • rebaseMergeAllowed: false GitHub UI: 'Allow rebase merging' 'Add all commits from the head branch onto the base branch individually.'
  • squashMergeAllowed: false GitHub UI: 'Allow squash merging' 'Combine all commits from the head branch into a single commit in the base branch.'
  • mergeCommitAllowed: true GitHub UI: 'Allow merge commits' 'Add all commits from the head branch to the base branch with a merge commit.'
  • It's not in the query above, but should perhaps also include pull request auto-merge (new for 2021) - from the docs I think this is autoMergeAllowed (boolean)
• These are perhaps general indicators of whether the repository is generally available or not:
  • isArchived: false
  • isDisabled: false
  • isLocked: false

Regarding isBlankIssuesEnabled, see this GitHub blog post. This doesn't quite mean what it's easy to assume it means. Needs more thought as, thus far - at least for open source repositories - we've remained pretty unopinionated about issue templates.