Azure / Azure/azure-cli

What is Demostleration? Just random stuff as example? Iteration Id does not work

Open
#24,536 4 comments 0 reactions 0 assignees View on GitHub
act-platform-engineering-squad customer-reported DevOps Service Attention
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 2h
Merged PRs (30d)
60

Description

The page says this
--iteration
Iteration path of the work item (e.g. DemosIteration 1).

Shouldn't iteration be an ID? How can that be DemosIteration?????? If it is not ID and this does not take a team then whose iteration will it create the work item in ? What does the comment "Iteration path" mean? Just unbelievable sloppy comment. Why can't this be the iteration Id just like how it is when the work items are listed?

And if I ignore this documentation and hoping the product is fine, give the iteration Id it gives the following very helpful message:

> "TF401347: Invalid tree name given for work item -1, field 'System.IterationPath'."

What is a tree? I did not order a tree, Microsoft. So, yeah there is some iteration path, but what is that?

Update: After many tries got the tree Microsoft meant here in the error message. It looks like (yes, a back slash, they can't seems to live without) "\Project-name\Team-name\Area-if-present\Sprint 25". But unfortunately even after giving that Microsoft product tells that I do not have permission do it. While I can do it from the UI without issues. Also tried with PAT tokens also does not work. Another hour of wasted time working with Microsoft stuff.

It is beyond repair how Microsoft documentation is. Half baked products and misleading documentation.

---
#### Document Details

⚠ *Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.*

* ID: 9efad9bc-ae60-ceaa-667f-6c89f97f9e45
* Version Independent ID: 578e1f79-dfe8-75f3-61c5-8ed609f45d6b
* Content: [az boards work-item](https://learn.microsoft.com/en-us/cli/azure/boards/work-item?view=azure-cli-latest)
* Content Source: [latest/docs-ref-autogen/boards/work-item.yml](https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/boards/work-item.yml)
* GitHub Login: @rloutlaw
* Microsoft Alias: **routlaw**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.