Skip to content

Commit 45d2feb

Browse files
fix(docs): satisfy markdownlint MD029 and editorconfig padding
Use consistent 1. ordered-list markers and even indentation under list continuations in TROUBLESHOOTING.md. Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 0611790 commit 45d2feb

1 file changed

Lines changed: 16 additions & 16 deletions

File tree

docs/TROUBLESHOOTING.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -128,11 +128,11 @@ Layout:
128128
```text
129129
~/.cache/cpa/
130130
catalog/
131-
templates.json
131+
templates.json
132132
repos/
133-
<cache-key>/
134-
.cpa-cache.json
135-
...
133+
<cache-key>/
134+
.cpa-cache.json
135+
...
136136
```
137137

138138
If a scaffold "looks weird" and you suspect a stale cache, the first diagnostic
@@ -198,24 +198,24 @@ uv --version
198198
create-awesome-python-app --info
199199
```
200200

201-
2. Check the generated project's `.python-version` and `requires-python` in
202-
`pyproject.toml` match your interpreter.
201+
1. Check the generated project's `.python-version` and `requires-python` in
202+
`pyproject.toml` match your interpreter.
203203

204-
3. Retry manually inside the project:
204+
1. Retry manually inside the project:
205205

206206
```bash
207207
cd my-app
208208
uv sync
209209
```
210210

211-
4. If you only need the file tree (no install), skip sync during scaffold:
211+
1. If you only need the file tree (no install), skip sync during scaffold:
212212

213213
```bash
214214
uvx create-awesome-python-app my-app -t fastapi-starter --no-install --no-interactive
215215
```
216216

217-
5. For network or index issues, retry with verbose logging or behind a proxy;
218-
CPA does not wrap `uv` output -- read the `uv sync` error directly.
217+
1. For network or index issues, retry with verbose logging or behind a proxy;
218+
CPA does not wrap `uv` output -- read the `uv sync` error directly.
219219

220220
## Git clone failures
221221

@@ -234,28 +234,28 @@ git --version
234234
create-awesome-python-app --info
235235
```
236236

237-
2. Warm the cache while online, then scaffold offline:
237+
1. Warm the cache while online, then scaffold offline:
238238

239239
```bash
240240
uvx create-awesome-python-app my-app -t fastapi-starter --no-interactive
241241
uvx create-awesome-python-app my-app2 -t fastapi-starter --offline --no-interactive
242242
```
243243

244-
3. For private repos, ensure SSH keys or credentials work outside CPA:
244+
1. For private repos, ensure SSH keys or credentials work outside CPA:
245245

246246
```bash
247247
git ls-remote git@github.com:your-org/your-template.git
248248
```
249249

250-
4. Clear a corrupted cache entry and retry:
250+
1. Clear a corrupted cache entry and retry:
251251

252252
```bash
253253
uvx create-awesome-python-app cache verify
254254
uvx create-awesome-python-app cache clean
255255
uvx create-awesome-python-app my-app -t fastapi-starter --no-interactive
256256
```
257257

258-
5. Use `file://` URLs to scaffold from a local checkout without network access.
258+
1. Use `file://` URLs to scaffold from a local checkout without network access.
259259

260260
## incompatibleWith errors
261261

@@ -273,9 +273,9 @@ layers before merging.
273273
uvx create-awesome-python-app --list-addons -t fastapi-starter
274274
```
275275

276-
2. Remove one extension from each conflicting pair in `--addons` / `--extend`.
276+
1. Remove one extension from each conflicting pair in `--addons` / `--extend`.
277277

278-
3. When authoring extensions, set `incompatibleWith` in `cpa.config.json`:
278+
1. When authoring extensions, set `incompatibleWith` in `cpa.config.json`:
279279

280280
```json
281281
{

0 commit comments

Comments
 (0)