Skip to content

Commit 3cc89ca

Browse files
docs: mention tabs in FAQs (#1034)
## PR Checklist - [x] Addresses an existing open issue: fixes #1023 - [x] That issue was marked as [`status: accepting prs`](https://github.com/JoshuaKGoldberg/create-typescript-app/issues?q=is%3Aopen+is%3Aissue+label%3A%22status%3A+accepting+prs%22) - [x] Steps in [CONTRIBUTING.md](https://github.com/JoshuaKGoldberg/create-typescript-app/blob/main/.github/CONTRIBUTING.md) were taken ## Overview Bumps down the heading level of the _"What tooling ..."_ heading so we can keep all h2s alphabetical.
1 parent 7ba6922 commit 3cc89ca

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

docs/FAQs.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ Each of the included tools exists for a good reason and provides real value.
105105

106106
If you don't want to use any particular tool, you can always remove it manually.
107107

108-
## What tooling does this package use that isn't part of created repositories?
108+
### What tooling does this package use that isn't part of created repositories?
109109

110110
Glad you asked!
111111
These are the projects used across many parts of `create-typescript-app`:
@@ -116,3 +116,16 @@ These are the projects used across many parts of `create-typescript-app`:
116116
- [Octokit](https://github.com/octokit/octokit.js#octokitjs):
117117
- [tsx](https://github.com/esbuild-kit/tsx): Quickly runs TypeScript files with ESBuild.
118118
- [Zod](https://zod.dev): TypeScript-first schema validation with static type inference.
119+
120+
## Why tabs?
121+
122+
This repository template configures `"useTabs": true` in the root-level `.prettierrc`.
123+
It does so because tabs have been phrased by the community as generally better for accessibility:
124+
125+
- <https://github.com/11ty/eleventy/issues/3098>
126+
- <https://github.com/prettier/prettier/issues/7475>
127+
128+
Note that those points on tabs over spaces have generally been made by accessibility-experienced _individuals_ rather than accessibility-focused _organizations_.
129+
If you know of any accessibility organization that's published more formal recommendations or research, please do file an issue here for this FAQ entry to be updated.
130+
131+
If you really want spaces in your project you can always remove the `"useTabs": true`.

0 commit comments

Comments
 (0)