VSCode - branch-creator README

Elevator pitch

Little utility extension that will allow the user's team to follow a consistent branch naming convention:

• Get a branch name from a single work item Id.
• Create said branch and checkout to it directly, or just copy it to your clipboard.

Requirements

This extension requires the user to have, either as an environment variable or as an item in the configuration file (explained below), their respective PAT (Personal Access Token) with Work Items Read permission (vso.work).

Extension Settings

This extension contributes the following settings, mandatory for the correct usage of this extension:

"branch-creator.config": {
    "organization": "foo",
    "team": "bar",
    "token": "my personal token"
}

• branch-creator.config.organization: The name of the Azure DevOps organization.
• branch-creator.config.team: Project ID or project name
• branch-creator.config.token: User's personal token with Work Items Read permission.