Setup your project

Work items are not directly linked to a repository in azure devops. doing looks for a .doing-cli-config.yml file in the root of your repository, that should contain information on how work items are linked. Every work item always has a organization, a devops project, a team, an area path, and an iteration path. For more background on this see this discussion.

The easiest way to setup that config file is by using a reference work item. Find the url and run doing init <url> in the root of your repository, which will create the config file with the required parameters for you. For example:

$ doing init https://dev.azure.com/organization_name/project_name/_workitems/edit/73554
> Created new .doing-cli-config.yml file
        > Filled in required parameters using reference work item #73554

Alternatively, create a .doing-cli-config.yml file in the root of your repository (you can use doing init to do that quickly) and specify the parameters. The easiest way to find these parameters is by creating or opening a work item, and copying the parameters from there. For information on how to find and set these parameters see the reference .doing-cli-config.yml config file

Verifying the setup

In the root of your repository, you can check if your configuration works using:

$ doing list
                 Work-items in current iteration project_name\team_name                  
┏━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━┓
┃     ID ┃                  Title ┃   Assignee ┃       Type ┃       Created ┃   PRs ┃
┡━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━┩
│  36893 │           explore data │ John       │ User Story │ 2 months ago  │       │
│  43769 │       feature pipeline │ Artur      │ User Story │ 5 days ago    │       │
│  99035 │             window bug │ Artur      │       Task │ 3 hours ago   │ 39949 │
│ 104436 │ data loading functions │ Jane       │       Task │ just now      │       │
└────────┴────────────────────────┴────────────┴────────────┴───────────────┴───────┘