Skip to content

Commit 4ffc4ee

Browse files
committed
Fix markdown lint spacing and list formatting
1 parent 6125787 commit 4ffc4ee

File tree

2 files changed

+12
-4
lines changed

2 files changed

+12
-4
lines changed

doc/elm_migrations_tsg.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,8 @@ az repos show --org https://dev.azure.com/myorg/ --project MyProject --repositor
112112
```
113113

114114
Example output:
115-
```
115+
116+
```text
116117
b3e18946-5b39-40ca-8e2f-d0eb683d8a85
117118
```
118119

@@ -343,6 +344,7 @@ az devops migrations resume --detect false --repository-id <GUID> --validate-onl
343344
**Symptom:** `Request failed with status 401` or `403`.
344345

345346
**Fix:**
347+
346348
1. Run `az login` (AAD) or `az devops login` (PAT).
347349
2. Ensure the token/account has permission to the organization.
348350
3. Verify `--org` points to the correct Azure DevOps org URL.
@@ -352,6 +354,7 @@ az devops migrations resume --detect false --repository-id <GUID> --validate-onl
352354
**Symptom:** `Request failed with status 404`.
353355

354356
**Fix:**
357+
355358
1. Verify `--org` is correct (e.g., `https://dev.azure.com/myorg`).
356359
2. Verify the `--repository-id` is a valid GUID that exists in the organization.
357360

@@ -360,6 +363,7 @@ az devops migrations resume --detect false --repository-id <GUID> --validate-onl
360363
**Symptom:** `Request failed with status 400` or `JsonReaderException`.
361364

362365
**Fix:**
366+
363367
1. Check date values are valid ISO 8601 strings (e.g., `2030-12-31T11:59:00Z`).
364368
2. Ensure `--target-repository` is a valid URL.
365369
3. Ensure `--agent-pool` matches a pool name the service recognizes.
@@ -380,6 +384,7 @@ az devops migrations create --detect false --repository-id <GUID> --target-repos
380384
```
381385

382386
Supported policy names:
387+
383388
- `None`
384389
- `ActivePullRequestCount`
385390
- `PullRequestDeltaSize`
@@ -397,26 +402,28 @@ Supported policy names:
397402
**Symptom:** `resume --migration` does not proceed, or returns a state error.
398403

399404
**Fix:**
405+
400406
1. Confirm current state first:
401407

402408
```powershell
403409
az devops migrations status --detect false --repository-id <GUID> -o json
404410
```
405411

406-
2. If migration is active, pause then retry:
412+
1. If migration is active, pause then retry:
407413

408414
```powershell
409415
az devops migrations pause --detect false --repository-id <GUID>
410416
az devops migrations resume --detect false --repository-id <GUID> --migration
411417
```
412418

413-
3. If migration already succeeded as full migration, abandon and recreate if needed.
419+
1. If migration already succeeded as full migration, abandon and recreate if needed.
414420

415421
### 406 Not Acceptable
416422

417423
**Symptom:** `Request failed with status 406`.
418424

419425
**Fix:**
426+
420427
1. Verify `--org` is correct.
421428
2. Confirm you are using the latest CLI extension version.
422429
3. Contact your admin if it persists.
@@ -426,6 +433,7 @@ az devops migrations resume --detect false --repository-id <GUID> --migration
426433
**Symptom:** `Max retries exceeded with url: ... (Caused by ResponseError('too many 500 error responses'))`.
427434

428435
**Fix:**
436+
429437
1. Check if the requests are going to the **wrong host** (e.g., `codedev.ms` instead of your org URL).
430438
- Run `az devops configure -l` to check your default org.
431439
- Fix with `az devops configure -d organization=https://dev.azure.com/<your-org>`.

doc/migrations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ az repos show --repository MyRepo --project MyProject --query id -o tsv
6060
- `--validate-only`: Resume in validate-only mode.
6161
- `--migration`: Promote a succeeded validate-only migration to full migration.
6262
This updates the existing migration by setting `validateOnly=false` and `statusRequested=active`.
63-
If a migration is currently active, pause it before resuming or switching mode.
63+
- If a migration is currently active, pause it before resuming or switching mode.
6464
- `cutover set` / `cutover cancel`: Schedule or cancel cutover.
6565
- `abandon`: Abandon and delete a migration.
6666

0 commit comments

Comments
 (0)