Add description field to features

source/features/add-co-authored-by.tsx

@@ -76,6 +76,7 @@ async function init(): Promise<void> {
 
 features.add({
 	id: 'add-co-authored-by',
+	description: 'Add co-authors when merging pull requests with multiple committers',
 	include: [
 		features.isPRConversation
 	],

source/features/batch-open-issues.tsx

@@ -66,6 +66,7 @@ function init(): void | false {
 
 features.add({
 	id: 'batch-open-issues',
+	description: 'Open multiple issues in your repo at once',
 	include: [
 		features.isDiscussionList
 	],

source/features/branch-buttons.tsx

@@ -121,6 +121,7 @@ async function init(): Promise<false | void> {
 
 features.add({
 	id: 'branch-buttons',
+	description: 'Quickly visit a repository’s default branch and latest version tag',
 	include: [
 		features.isRepoTree,
 		features.isSingleFile

source/features/bypass-checks.tsx

@@ -15,6 +15,7 @@ async function bypass(check: HTMLElement): Promise<void> {
 
 features.add({
 	id: 'bypass-checks',
+	description: 'Bypass the `Checks` page and go directly to build results when clicking the `Details` links on a pull request',
 	include: [
 		features.isPRConversation
 	],

source/features/ci-link.tsx

@@ -33,6 +33,7 @@ async function init(): Promise<false | void> {
 
 features.add({
 	id: 'ci-link',
+	description: 'Add build status and link to CI after the repo’s title',
 	include: [
 		features.isRepo
 	],

source/features/clean-sidebar.tsx

@@ -1,7 +1,3 @@
-/*
-Hide all empty sections (or just their "empty" label) in discussion sidebar
-*/
-
 import './clean-sidebar.css';
 import React from 'dom-chef';
 import select from 'select-dom';
@@ -88,6 +84,7 @@ function init(): void {
 
 features.add({
 	id: 'link-to-file-in-file-history',
+	description: 'Hide all empty sections (or just their "empty" label) in the discussion sidebar',
 	include: [
 		features.isIssue,
 		features.isPRConversation

source/features/close-out-of-view-modals.tsx

@@ -19,5 +19,6 @@ function init(): void {
 
 features.add({
 	id: 'close-out-of-view-modals',
+	description: 'Automatically close modals when they’re no longer visible',
 	init
 });

source/features/collapsible-content-button.tsx

@@ -1,9 +1,3 @@
-/*
-Insert collapsible content when writing comments (via `<summary>`)
-
-https://user-images.githubusercontent.com/1402241/53678019-0c721280-3cf4-11e9-9c24-4d11a697f67c.png
-*/
-
 import React from 'dom-chef';
 import select from 'select-dom';
 import delegate, {DelegateEvent} from 'delegate-it';
@@ -70,6 +64,7 @@ function addContentToDetails(event: DelegateEvent<MouseEvent, HTMLButtonElement>
 
 features.add({
 	id: 'collapsible-content-button',
+	description: 'Insert collapsible content when writing comments (via `<summary>`) https://user-images.githubusercontent.com/1402241/53678019-0c721280-3cf4-11e9-9c24-4d11a697f67c.png',
 	include: [
 		features.hasRichTextEditor
 	],

source/features/comment-fields-keyboard-shortcuts.tsx

@@ -81,6 +81,7 @@ function init(): void {
 
 features.add({
 	id: 'comment-fields-keyboard-shortcuts',
+	description: 'Quickly edit your last comment using the `↑` keyboard shortcut',
 	shortcuts: {
 		'↑': 'Edit your last comment'
 	},

source/features/comments-time-machine-links.tsx

@@ -71,6 +71,7 @@ function init(): void {
 
 features.add({
 	id: 'comments-time-machine-links',
+	description: 'Browse a repository at the time of each comment',
 	include: [
 		features.hasComments
 	],

source/features/copy-file.tsx

@@ -44,6 +44,7 @@ function init(): void {
 
 features.add({
 	id: 'copy-file',
+	description: 'Copy a file’s content',
 	include: [
 		features.isSingleFile,
 		features.isGist

source/features/copy-on-y.tsx

@@ -19,6 +19,7 @@ function deinit(): void {
 
 features.add({
 	id: 'copy-on-y',
+	description: 'Add keyboard shortcut to copy the permalink of a file to the clipboard',
 	include: [
 		features.isSingleFile
 	],

source/features/create-release-shortcut.tsx

@@ -10,6 +10,7 @@ function init(): void {
 
 features.add({
 	id: 'create-release-shortcut',
+	description: 'Add keyboard shortcut to quickly create a new release',
 	include: [
 		features.isReleasesOrTags
 	],

source/features/default-to-rich-diff.tsx

@@ -1,8 +1,3 @@
-/**
- * Some of the files in PRs can be reviewed using a rich-diff mode: markdown and SVGs are some of the examples.
- *
- * This feature sets the rich-diff view as default for each SVG file in a PR
- */
 import select from 'select-dom';
 import features from '../libs/features';
 
@@ -42,6 +37,7 @@ function init(): void {
 
 features.add({
 	id: 'default-to-rich-diff',
+	description: 'Some of the files in pull requests can be reviewed using a rich-diff mode, for example, Markdown and SVG. This feature sets the rich-diff view as default in pull requests for files with a rich diff.',
 	include: [
 		features.isCommit,
 		features.isPRFiles

source/features/download-folder-button.tsx

@@ -17,6 +17,7 @@ function init(): void {
 
 features.add({
 	id: 'download-folder-button',
+	description: 'Download entire folders from repositories using the `Download folder` button. (Uses https://download-directory.github.io)',
 	include: [
 		features.isRepoTree
 	],

source/features/edit-comments-faster.tsx

@@ -34,6 +34,7 @@ function init(): void {
 
 features.add({
 	id: 'edit-comments-faster',
+	description: 'Edit comments in one click',
 	include: [
 		features.hasComments
 	],

source/features/edit-files-faster.tsx

@@ -1,7 +1,3 @@
-/*
-Edit files straight from a repo’s list by clicking their icon.
-*/
-
 import './edit-files-faster.css';
 import React from 'dom-chef';
 import select from 'select-dom';
@@ -29,6 +25,7 @@ function init(): void {
 
 features.add({
 	id: 'edit-files-faster',
+	description: 'Edit files straight from a repo’s file list by clicking their file icon',
 	include: [
 		features.isRepoTree
 	],

source/features/embed-gist-inline.tsx

@@ -50,6 +50,7 @@ function init(): void {
 
 features.add({
 	id: 'embed-gist-inline',
+	description: 'View linked gists inline in comments',
 	include: [
 		features.hasComments
 	],

source/features/emojis-title.tsx

@@ -12,6 +12,7 @@ function init(): void {
 
 features.add({
 	id: 'emojis-title',
+	description: 'Don’t add a title if the emoji’s parents already have one',
 	load: features.onAjaxedPages,
 	init
 });

source/features/esc-to-deselect-line.tsx

@@ -1,7 +1,3 @@
-/*
-If you select a line in a file, pressing ESC will deselect it.
-*/
-
 import features from '../libs/features';
 
 function isLineSelected(): boolean {
@@ -29,5 +25,6 @@ function init(): void {
 
 features.add({
 	id: 'esc-to-deselect-line',
+	description: 'Press the `esc` key to deselect the current line when viewing files',
 	init
 });

source/features/extend-diff-expander.tsx

@@ -16,6 +16,7 @@ function init(): void {
 
 features.add({
 	id: 'extend-diff-expander',
+	description: 'Widen the `Expand diff` button',
 	include: [
 		features.isPRFiles,
 		features.isCommit

source/features/extend-status-labels.tsx

@@ -34,6 +34,7 @@ function init(): false | void {
 
 features.add({
 	id: 'extend-status-labels',
+	description: 'Add reference to PR/commit that closed the current issue/PR (https://user-images.githubusercontent.com/1402241/35973522-5c00acb6-0d08-11e8-89ca-03071de15c6f.png)',
 	include: [
 		features.isPRConversation,
 		features.isIssue

source/features/faster-pr-diff-options.tsx

@@ -82,6 +82,7 @@ function init(): false | void {
 
 features.add({
 	id: 'faster-pr-diff-options',
+	description: 'Change diff style and whitespace visibility in one click',
 	include: [
 		features.isPRFiles,
 		features.isCommit

source/features/filter-comments-by-you.tsx

@@ -21,6 +21,7 @@ function init(): void {
 
 features.add({
 	id: 'filter-comments-by-you',
+	description: 'Search for issues and pull requests with the "Everything commented by you filter"',
 	include: [
 		features.isRepoDiscussionList
 	],

source/features/filter-pr-by-build-status.tsx

@@ -1,9 +1,3 @@
-/**
-This feature lets you filter the PRs by their build status, namely success, failure, and pending.
-For more information read the GitHub blog: https://github.blog/2015-06-02-filter-pull-requests-by-status/
-
-See it in action at https://github.com/sindresorhus/refined-github/pulls
-*/
 import React from 'dom-chef';
 import select from 'select-dom';
 import {checkInline} from '../libs/icons';
@@ -59,6 +53,7 @@ function init(): void | false {
 
 features.add({
 	id: 'filter-pr-by-build-status',
+	description: 'Filter pull requests by their build status (success, failure, and pending)',
 	include: [
 		features.isPRList
 	],

source/features/fit-textareas.tsx

@@ -1,8 +1,3 @@
-/*
-Automatically expands textareas to fit ALL of their content, rather than have a height limit like GitHub's native "fit to content" behavior.
-https://user-images.githubusercontent.com/1402241/54336211-66fd5e00-4666-11e9-9c5e-111fccab004d.gif
-*/
-
 import './fit-textareas.css';
 import delegate, {DelegateEvent} from 'delegate-it';
 import fitTextarea from 'fit-textarea';
@@ -23,5 +18,6 @@ function init(): void {
 
 features.add({
 	id: 'fit-textareas',
+	description: 'Automatically expand textareas to fit all of their content, rather than have a height limit like GitHub’s native "fit to content" behavior (https://user-images.githubusercontent.com/1402241/54336211-66fd5e00-4666-11e9-9c5e-111fccab004d.gif)',
 	init
 });

source/features/focus-confirmation-buttons.tsx

@@ -1,7 +1,6 @@
 import select from 'select-dom';
 import features from '../libs/features';
 
-// Ensure that confirm buttons (like Mark all as read) are always in focus
 function init(): void {
 	window.addEventListener('facebox:reveal', () => {
 		select<HTMLButtonElement>('.facebox-content button')!.focus();
@@ -10,5 +9,6 @@ function init(): void {
 
 features.add({
 	id: 'focus-confirmation-buttons',
+	description: 'Ensure that confirm buttons, like "Mark all as read", are always in focus',
 	init
 });

source/features/follow-file-renames.tsx

@@ -1,7 +1,3 @@
-/*
-In commits list, it enables Newer/Older buttons to follow file renames
-*/
-
 import React from 'dom-chef';
 import select from 'select-dom';
 import features from '../libs/features';
@@ -14,7 +10,7 @@ interface File {
 	status: string;
 }
 
-// TODO: ensure that pages with a single commit aren't fetched twice (api.ts' cache should do it automatically)
+// TODO: Ensure that pages with a single commit aren't fetched twice (api.ts' cache should do it automatically)
 async function findRename(
 	user: string,
 	repo: string,
@@ -66,6 +62,7 @@ async function init(): Promise<false | void> {
 
 features.add({
 	id: 'follow-file-renames',
+	description: 'Enable Newer/Older buttons in commit lists to follow file renames',
 	include: [
 		features.isCommitList
 	],

source/features/global-discussion-list-filters.tsx

@@ -42,6 +42,7 @@ function init(): void {
 
 features.add({
 	id: 'global-discussion-list-filters',
+	description: 'See just the issues and PRs on your repos or commented on by you in the global Issues/Pull Requests pages',
 	include: [
 		features.isGlobalDiscussionList
 	],

source/features/hide-comments-faster.tsx

@@ -61,6 +61,7 @@ function init(): void {
 
 features.add({
 	id: 'hide-comments-faster',
+	description: 'Hide comments in fewer clicks',
 	include: [
 		features.hasComments
 	],

source/features/hide-disabled-milestone-sorter.tsx

@@ -14,6 +14,7 @@ function init(): void {
 
 features.add({
 	id: 'hide-disabled-milestone-sorter',
+	description: 'Hide the milestone drag icon when you don’t have permission to sort the milestones',
 	include: [
 		features.isMilestone
 	],

source/features/hide-empty-meta.tsx

@@ -9,6 +9,7 @@ function init(): void {
 
 features.add({
 	id: 'hide-empty-meta',
+	description: 'Hide nonessential files from the GitHub file browser',
 	include: [
 		features.isRepoRoot
 	],

source/features/hide-inactive-deployments.tsx

@@ -14,6 +14,7 @@ function init(): void {
 
 features.add({
 	id: 'hide-inactive-deployments',
+	description: 'Hide inactive deployments in pull requests',
 	include: [
 		features.isPRConversation
 	],

source/features/hide-issue-list-autocomplete.tsx

@@ -7,6 +7,7 @@ function init(): void {
 
 features.add({
 	id: 'hide-issue-list-autocomplete',
+	description: 'The autocomplete on the issue search field is removed',
 	include: [
 		features.isDiscussionList
 	],

source/features/hide-navigation-hover-highlight.tsx

@@ -1,12 +1,3 @@
-/*
-Some lists like notifications, file lists, and issue lists,
-are highlighted as you move the mouse over them. This highlight
-is useful when navigating via the keyboard (j/k), but annoying
-when just moving the mouse around.
-
-This feature will hide the highlight until the first keyboard
-navigation, then it will be displayed until the next full reload.
-*/
 import './hide-navigation-hover-highlight.css';
 import features from '../libs/features';
 
@@ -21,5 +12,6 @@ function init(): void {
 
 features.add({
 	id: 'hide-navigation-hover-highlight',
+	description: 'Some lists like notifications, file lists, and issue lists, are highlighted as you move the mouse over them. This highlight is useful when navigating via the keyboard (j/k), but annoying when just moving the mouse around.\n\nThis feature will hide the highlight until the first keyboard navigation, then it will be displayed until the next full reload.',
 	init
 });

source/features/hide-own-stars.tsx

@@ -1,6 +1,3 @@
-/*
-Hide other users starring/forking your repos
-*/
 import select from 'select-dom';
 import features from '../libs/features';
 import {getUsername} from '../libs/utils';
@@ -28,6 +25,7 @@ async function init(): Promise<void> {
 
 features.add({
 	id: 'hide-own-stars',
+	description: 'Hide other users starring/forking your repos in the dashboard',
 	include: [
 		features.isDashboard
 	],

source/features/hide-useless-comments.tsx

@@ -57,6 +57,7 @@ function unhide(event: React.MouseEvent<HTMLButtonElement>): void {
 
 features.add({
 	id: 'hide-useless-comments',
+	description: 'Hide useless comments like "+1"',
 	include: [
 		features.isIssue
 	],