X-Git-Url: https://src.twobees.de/?a=blobdiff_plain;f=stow%2Foh-my-zsh%2F.oh-my-zsh%2Fplugins%2Fjira%2FREADME.md;fp=stow%2Foh-my-zsh%2F.oh-my-zsh%2Fplugins%2Fjira%2FREADME.md;h=0000000000000000000000000000000000000000;hb=1a8e170bbe5c6641a26ab1ce2e6ce6c5c1faa4cd;hp=a5633af77c357eae2c4382ea626ce25eaf95b0b6;hpb=475ba35502579302593f4735c853c49ef1845dcb;p=dotfiles.git diff --git a/stow/oh-my-zsh/.oh-my-zsh/plugins/jira/README.md b/stow/oh-my-zsh/.oh-my-zsh/plugins/jira/README.md deleted file mode 100644 index a5633af..0000000 --- a/stow/oh-my-zsh/.oh-my-zsh/plugins/jira/README.md +++ /dev/null @@ -1,70 +0,0 @@ -# Jira plugin # - -CLI support for JIRA interaction - -## Description ## - -This plugin provides command line tools for interacting with Atlassian's [JIRA](https://www.atlassian.com/software/jira) bug tracking software. - -The interaction is all done through the web. No local installation of JIRA is necessary. - -In this document, "JIRA" refers to the JIRA issue tracking server, and `jira` refers to the command this plugin supplies. - -## Usage ## - -This plugin supplies one command, `jira`, through which all its features are exposed. Most forms of this command open a JIRA page in your web browser. - -``` -jira # performs the default action - -jira new # opens a new issue -jira dashboard # opens your JIRA dashboard -jira tempo # opens your JIRA Tempo -jira reported [username] # queries for issues reported by a user -jira assigned [username] # queries for issues assigned to a user -jira myissues # queries for you own issues -jira branch # opens an existing issue matching the current branch name - # The branch name may have prefixes ending in "/": "feature/MP-1234", - # and also suffixes starting with "_": "MP-1234_fix_dashboard" - # In both these cases, the issue opened will be "MP-1234" -jira ABC-123 # opens an existing issue -jira ABC-123 m # opens an existing issue for adding a comment -``` - -#### Debugging usage #### - -These calling forms are for developers' use, and may change at any time. - -``` -jira dumpconfig # displays the effective configuration -``` - -## Setup ## - -The URL for your JIRA instance is set by `$JIRA_URL` or a `.jira_url` file. - -Add a `.jira-url` file in the base of your project. You can also set `$JIRA_URL` in your `~/.zshrc` or put a `.jira-url` in your home directory. A `.jira-url` in the current directory takes precedence, so you can make per-project customizations. - -The same goes with `.jira-prefix` and `$JIRA_PREFIX`. These control the prefix added to all issue IDs, which differentiates projects within a JIRA instance. - -For example: - -``` -cd to/my/project -echo "https://jira.atlassian.com" >> .jira-url -``` - -(Note: The current implementation only looks in the current directory for `.jira-url` and `.jira-prefix`, not up the path, so if you are in a subdirectory of your project, it will fall back to your default JIRA URL. This will probably change in the future though.) - -### Variables ### - -* `$JIRA_URL` - Your JIRA instance's URL -* `$JIRA_NAME` - Your JIRA username; used as the default user for `assigned`/`reported` searches -* `$JIRA_PREFIX` - Prefix added to issue ID arguments -* `$JIRA_RAPID_BOARD` - Set to `true` if you use Rapid Board -* `$JIRA_DEFAULT_ACTION` - Action to do when `jira` is called with no arguments; defaults to "new" - - -### Browser ### - -Your default web browser, as determined by how `open_command` handles `http://` URLs, is used for interacting with the JIRA instance. If you change your system's URL handler associations, it will change the browser that `jira` uses.