Repository: cli/cli
File: pkg/cmd/accessibility/accessibility.go (Go)

Code before:
			# Open the GitHub Accessibility site in your browser
			$ gh accessibility --web

			# Display color using customizable, 4-bit accessible colors
			$ gh config set accessible_colors enabled

			# Display issue and pull request labels using RGB hex color codes in terminals that support 24-bit true color
			$ gh config set color_labels enabled

			# Use input prompts without redrawing the screen
			$ gh config set accessible_prompter enabled

			# Disable motion-based spinners for progress indicators in favor of text
			$ gh config set spinner disabled
		`),
	}

	cmd.Flags().BoolVarP(&opts.Web, "web", "w", false, "Open the GitHub Accessibility site in your browser")
	cmdutil.DisableAuthCheck(cmd)

	return cmd
}

func longDescription(io *iostreams.IOStreams) string {
	cs := io.ColorScheme()
	title := cs.Bold("Learn about GitHub CLI accessibility experiences")
	color := cs.Bold("Customizable and contrasting colors")
	prompter := cs.Bold("Non-interactive user input prompting")
	spinner := cs.Bold("Text-based spinners")
	feedback := cs.Bold("Join the conversation")

	return heredoc.Docf(`
		%[2]s

		As the home for all developers, we want every developer to feel welcome in our
		community and be empowered to contribute to the future of global software
		development with everything GitHub has to offer including the GitHub CLI.

		%[3]s

		Text interfaces often use color for various purposes, but insufficient contrast
		or customizability can leave some users unable to benefit.

		To create a more accessible experience, the GitHub CLI will use color palettes
		based on terminal background appearance and limit colors to 4-bit ANSI color
		palettes, which users can customize within terminal preferences.

		With this new experience, the GitHub CLI provides multiple options to address
		color usage:

		1. The GitHub CLI will use 4-bit color palette for increased color contrast based

Review comment (suggestion):
```suggestion
	title := cs.Bold("Learn about GitHub CLI's accessibility experiences")
```

Code after:
			# Open the GitHub Accessibility site in your browser
			$ gh accessibility --web

			# Display color using customizable, 4-bit accessible colors
			$ gh config set accessible_colors enabled

			# Use input prompts without redrawing the screen
			$ gh config set accessible_prompter enabled

			# Disable motion-based spinners for progress indicators in favor of text
			$ gh config set spinner disabled
		`),
	}

	cmd.Flags().BoolVarP(&opts.Web, "web", "w", false, "Open the GitHub Accessibility site in your browser")
	cmdutil.DisableAuthCheck(cmd)

	return cmd
}

func longDescription(io *iostreams.IOStreams) string {
	cs := io.ColorScheme()
	title := cs.Bold("Learn about GitHub CLI's accessibility experiences")
	color := cs.Bold("Customizable and contrasting colors")
	prompter := cs.Bold("Non-interactive user input prompting")
	spinner := cs.Bold("Text-based spinners")
	feedback := cs.Bold("Join the conversation")

	return heredoc.Docf(`
		%[2]s

		As the home for all developers, we want every developer to feel welcome in our
		community and be empowered to contribute to the future of global software
		development with everything GitHub has to offer including the GitHub CLI.

		%[3]s

		Text interfaces often use color for various purposes, but insufficient contrast
		or customizability can leave some users unable to benefit.

		For a more accessible experience, the GitHub CLI can use color palettes
		based on terminal background appearance and limit colors to 4-bit ANSI color
		palettes, which users can customize within terminal preferences.

		With this new experience, the GitHub CLI provides multiple options to address
		color usage:

		1. The GitHub CLI will use 4-bit color palette for increased color contrast based
		   on dark and light backgrounds including rendering Markdown based on the
		   GitHub Primer design system.