References and Links

There are many ways that you can link your Issues within Copia, and also perform actionable references. This makes it easy to cross reference your Issue to a PR or commit, and also automatically close or re-open your issue by performing a merge or commit.

Linking

Every issue is assigned an ID, which is preceded by the # sign, after the title of the image. This ID can be used to reference the issue in comments and descriptions within Copia.

Within a Repository

A reference to an Issue within the same repository can be created using the simple notation #123, where 123 is the ID of the Issue in the same repository. The references will be shown as link to the Issue.

In another Repository

A reference to an Issue within another repository can be created by specifying both the Organization and the repository first, such as orgname/reponame#123, where 123 is the ID of the Issue. The references will be shown as link to the Issue.

Actionable References

Copia also supports automatically closing and re-opening an Issue through the use of actionable references. By using the Issue ID, along with certain keywords, the action will be taken. For example, if you enter closes #123 in the commit message, it will automatically close the corresponding Issue referenced.

Below is a list of keywords that can be used.

• Closing: close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved

• Reopening: reopen, reopens, reopened

In addition, there are a few conditions which must be met:

• The commenter must have permission to close or reopen the issue.

• The reference is inside a commit message.

• The reference is posted as part of the pull request description.