Skip to content

Extended feature descriptions

Federico Brigante edited this page Sep 5, 2024 · 11 revisions

pr-branch-auto-delete

After clicking "Merge", this feature will attempt automatically deleting the head branch to keep the repository clean. The deletion doesn't happen when:

  • You don't have permission to delete the branch (e.g. it has branch protections or it's from a fork)
  • The branch name matches one of the exceptions (e.g. prod, develop, see the full list in the feature source)
  • There are open PRs pointing to said branch

To avoid automatic branch deletion, enable branch protection on branches you want to keep.

If you don't like this feature, disable it.

clear-pr-merge-commit-message

On PRs, when squashing, the commit description is filled with every commit's title.

If you squash, probably aren't interested in every commit's title and should therefore be dropped. If they're useful, maybe you should merge or rebase instead.

Note This feature overrides any related GitHub settings. Please disable the feature if that's not what you want.

closing-remarks

The feature asks GitHub what tags the merge commit appears in and it will show the first one in the list. Number-less tags and "nightly" tags are excluded.

There are a number of limitations we face:

  • Tags are sorted alphabetically, the first one is picked. If you tag your repo consistently this is not an issue
  • The sorting cannot be changed, we just fetch it from GitHub
  • The exact merge commit needs to appear under the tag, rebased commits are ignored

new-repo-disable-projects-and-wikis

Projects and wikis are used by a minority of users so Refined GitHub defaults to disabling them when creating a new repo. This can be avoided by unticking the checkbox before creating a new repo.

prevent-link-loss

GitHub has this really annoying bug that changes pull request commit links:

https://github.com/sindresorhus/refined-github/pull/3/commits/cb44a4eb8cd5c66def3dc26dca0f386645fa29bb

into non-pull-request-related links like:

https://github.com/sindresorhus/refined-github/commit/cb44a4eb8cd5c66def3dc26dca0f386645fa29bb

This bug applies to raw URLs but not URLs that are already part of a Markdown link, like:

[my commit](https://github.com/sindresorhus/refined-github/pull/3/commits/cb44a4eb8cd5c66def3dc26dca0f386645fa29bb)

Refined GitHub's prevent-link-loss feature will prompt you to fix this link and you can do so with a click:

demo gif

filler to allow extra scroll