# Issues in github

**URL:** <https://discourse.itk.org/t/issues-in-github/1218>\
**Category:** Engineering\
**Created:** [August 22, 2018, 7:56am UTC](https://discourse.itk.org/t/issues-in-github/1218 "2018-08-22T07:56:47Z")\
**Posts on this page:** 16\
**Page:** 1

<div class="post-metadata">

**Author:** ![phcerdan](https://discourse.itk.org/user_avatar/discourse.itk.org/phcerdan/32/286_2.png) [@phcerdan](https://discourse.itk.org/u/phcerdan)\
**Post date:** [August 22, 2018, 7:56am UTC](https://discourse.itk.org/t/issues-in-github/1218/1 "2018-08-22T07:56:47Z")

</div>

What is the status on allowing opening issues in the github mirror [https://github.com/InsightSoftwareConsortium/ITK](https://github.com/InsightSoftwareConsortium/ITK)?

I have some really minor warnings I find building tests, and an issue in github would be better than report it here. I still have problems logging into [https://insightsoftwareconsortium.atlassian.net/secure/Dashboard.jspa](https://insightsoftwareconsortium.atlassian.net/secure/Dashboard.jspa), as I guess any new user not registered in the server.

Thanks!

---

<div class="post-metadata">

**Author:** ![lassoan](https://discourse.itk.org/user_avatar/discourse.itk.org/lassoan/32/27_2.png) [@lassoan](https://discourse.itk.org/u/lassoan)\
**Post date:** [August 22, 2018, 7:19pm UTC](https://discourse.itk.org/t/issues-in-github/1218/2 "2018-08-22T19:19:53Z")

</div>

Using Github for issue tracking would be very community-friendly: people would not have to create yet another account (by the way, I still cannot do anything on Jira) or need to learn how to use a new issue tracker (that most likely they would very rarely use).

We would also benefit from the integration between repository and issues, especially if the github repository was promoted to be the official repository (not just a mirror).

There are of course somed drawbacks. Github’s issue tracker is extremely limited: it cannot be configured to support sophisticated software development process. Something would need to be done with existing issues: as usual, with yet another migration we would further deteriorate the quality of the database; if we don’t migrate the data then we cannot get rid of the current database for a good while.

---

<div class="post-metadata">

**Author:** ![matt.mccormick](https://discourse.itk.org/user_avatar/discourse.itk.org/matt.mccormick/32/7_2.png) [@matt.mccormick](https://discourse.itk.org/u/matt.mccormick)\
**Post date:** [August 23, 2018, 5:56pm UTC](https://discourse.itk.org/t/issues-in-github/1218/3 "2018-08-23T17:56:50Z")

</div>

GitHub is much easier to use than Jira, vastly more efficient to use than Jira, and it integrates better with the GitHub activity in pull requests for ITK but also other related community projects on GitHub.

While we are not yet ready to promote the GitHub to be the official `ITK` repository because of other infrastructure issues, we could go ahead and use GitHub Issues as our issue tracker.

I think the clutter caused by a migration of Jira Issues to GitHub would cause more confusion than actual usefulness. Also, I do not think anyone has the cycles to do it properly. @hjmjohnson successfully managed to migrate our Jira instance to a sustainable, free Atlassian cloud-based service for open source projects – the existing issues should be available for reference for the foreseeable future.

---

<div class="post-metadata">

**Author:** ![hjmjohnson](https://discourse.itk.org/user_avatar/discourse.itk.org/hjmjohnson/32/23_2.png) [@hjmjohnson](https://discourse.itk.org/u/hjmjohnson)\
**Post date:** [August 23, 2018, 6:10pm UTC](https://discourse.itk.org/t/issues-in-github/1218/4 "2018-08-23T18:10:05Z")

</div>

+1

Hans

---

<div class="post-metadata">

**Author:** ![phcerdan](https://discourse.itk.org/user_avatar/discourse.itk.org/phcerdan/32/286_2.png) [@phcerdan](https://discourse.itk.org/u/phcerdan)\
**Post date:** [August 23, 2018, 8:12pm UTC](https://discourse.itk.org/t/issues-in-github/1218/5 "2018-08-23T20:12:16Z")

</div>

I tried, but I couldn’t resist opening the first issue! [https://github.com/InsightSoftwareConsortium/ITK/issues/54](https://github.com/InsightSoftwareConsortium/ITK/issues/54)

This is great, thanks!

---

<div class="post-metadata">

**Author:** ![jhlegarreta](https://discourse.itk.org/user_avatar/discourse.itk.org/jhlegarreta/32/476_2.png) [@jhlegarreta](https://discourse.itk.org/u/jhlegarreta)\
**Post date:** [August 25, 2018, 1:09am UTC](https://discourse.itk.org/t/issues-in-github/1218/6 "2018-08-25T01:09:09Z")

</div>

@lassoan I am sorry; I tried to add your email to the JIRA reporters, but for some unknown reason only people having a [kitware.com](http://kitware.com) or [mail.nih.gov](http://mail.nih.gov) and a couple of other domains that exclude a large part of our community can be added.

We are certainly not managing this correctly, since there was a [recent message to the discussion forum](https://discourse.itk.org/t/how-to-report-itk-issues/991) from yourself on virtually the same topic. At that time we managed to add Gabriel, and we found no such domain restrictions.

Although switching to GitHub issues, issues reported in JIRA are still important, and to enable a proper follow-up to fix and close the issues, it woud be necessary to address these issues with JIRA.

@hjmjohnson I can’t find where the error lies. I seem to have the rights to add people, but I ignore why the domain rule is there/how to change it.

JON HAITZ

---

<div class="post-metadata">

**Author:** ![hjmjohnson](https://discourse.itk.org/user_avatar/discourse.itk.org/hjmjohnson/32/23_2.png) [@hjmjohnson](https://discourse.itk.org/u/hjmjohnson)\
**Post date:** [August 25, 2018, 1:30am UTC](https://discourse.itk.org/t/issues-in-github/1218/7 "2018-08-25T01:30:16Z")

</div>

The defaults seems overly restrictive, so I updated them to be more inclusive.

Hans

 ![](https://discourse.itk.org/uploads/default/original/1X/885065fddc0ec7d28f400ee9601d29f735f985e9.png)

---

<div class="post-metadata">

**Author:** ![jhlegarreta](https://discourse.itk.org/user_avatar/discourse.itk.org/jhlegarreta/32/476_2.png) [@jhlegarreta](https://discourse.itk.org/u/jhlegarreta)\
**Post date:** [August 26, 2018, 5:31pm UTC](https://discourse.itk.org/t/issues-in-github/1218/8 "2018-08-26T17:31:40Z")

</div>

@hjmjohnson thanks for doing this. I was able to add @lassoan to the Jira users.

@lassoan if there are issues that you are participating in, you could now try to update them if necessary, and let us know if what has been done allows you to do what you’d expect to.

Thanks.

---

<div class="post-metadata">

**Author:** ![lassoan](https://discourse.itk.org/user_avatar/discourse.itk.org/lassoan/32/27_2.png) [@lassoan](https://discourse.itk.org/u/lassoan)\
**Post date:** [August 26, 2018, 5:36pm UTC](https://discourse.itk.org/t/issues-in-github/1218/9 "2018-08-26T17:36:52Z")

</div>

> [@jhlegarreta](#):
>
> I was able to add @lassoan to the Jira users

Thank you, I confirm that my account is functional. I can now add new issue, comment on existing issues, etc.

---

<div class="post-metadata">

**Author:** ![matt.mccormick](https://discourse.itk.org/user_avatar/discourse.itk.org/matt.mccormick/32/7_2.png) [@matt.mccormick](https://discourse.itk.org/u/matt.mccormick)\
**Post date:** [August 27, 2018, 2:22pm UTC](https://discourse.itk.org/t/issues-in-github/1218/10 "2018-08-27T14:22:43Z")

</div>

> [@lassoan](#):
>
> > I was able to add @lassoan to the Jira users
> 
> Thank you, I confirm that my account is functional. I can now add new issue, comment on existing issues, etc.

Thanks @jhlegarreta @hjmjohnson for fixing this ☀

> [@jhlegarreta](#):
>
> I tried to add your email to the JIRA reporters, but for some unknown reason only people having a [kitware.com](http://kitware.com) or [mail.nih.gov](http://mail.nih.gov) and a couple of other domains that exclude a large part of our community can be added.

Exclusion is certainly not the intention. Migrating to GitHub Issues should help include more of the community, regardless.

---

<div class="post-metadata">

**Author:** ![seanm](https://discourse.itk.org/letter_avatar_proxy/v4/letter/s/a88e4f/32.png) [@seanm](https://discourse.itk.org/u/seanm)\
**Post date:** [August 28, 2018, 6:17pm UTC](https://discourse.itk.org/t/issues-in-github/1218/11 "2018-08-28T18:17:48Z")

</div>

Could we at least have the github issues start at a number larger than the largest issue number in jira? That would avoid confusion with commit messages in git history that might say something like “fixed issue #123”.

---

<div class="post-metadata">

**Author:** ![matt.mccormick](https://discourse.itk.org/user_avatar/discourse.itk.org/matt.mccormick/32/7_2.png) [@matt.mccormick](https://discourse.itk.org/u/matt.mccormick)\
**Post date:** [August 28, 2018, 6:59pm UTC](https://discourse.itk.org/t/issues-in-github/1218/12 "2018-08-28T18:59:30Z")

</div>

This is a good idea, but it does not appear to be an option in GitHub’s configuration. The previous reference pattern was _ITK-NNNN_. Now, we should adopt _#NN_? Thoughts?

---

<div class="post-metadata">

**Author:** ![dzenanz](https://discourse.itk.org/user_avatar/discourse.itk.org/dzenanz/32/1093_2.png) [@dzenanz](https://discourse.itk.org/u/dzenanz)\
**Post date:** [August 28, 2018, 8:43pm UTC](https://discourse.itk.org/t/issues-in-github/1218/13 "2018-08-28T20:43:44Z")

</div>

I thought GitHub only supports `#NN` style for both PRs and issues. So there is no option really than to go with the usual `Closes #123` somewhere in commit message.

---

<div class="post-metadata">

**Author:** ![matt.mccormick](https://discourse.itk.org/user_avatar/discourse.itk.org/matt.mccormick/32/7_2.png) [@matt.mccormick](https://discourse.itk.org/u/matt.mccormick)\
**Post date:** [September 5, 2018, 4:36pm UTC](https://discourse.itk.org/t/issues-in-github/1218/14 "2018-09-05T16:36:24Z")

</div>

[http://issues.itk.org](http://issues.itk.org) now points to the GitHub issue tracker 🎇

---

<div class="post-metadata">

**Author:** ![matt.mccormick](https://discourse.itk.org/user_avatar/discourse.itk.org/matt.mccormick/32/7_2.png) [@matt.mccormick](https://discourse.itk.org/u/matt.mccormick)\
**Post date:** [September 5, 2018, 4:59pm UTC](https://discourse.itk.org/t/issues-in-github/1218/15 "2018-09-05T16:59:17Z")

</div>

Documentation for the new issue reference syntax is updated here:

[http://review.source.kitware.com/#/c/23689/](http://review.source.kitware.com/#/c/23689/)

---

<div class="post-metadata">

**Author:** ![lassoan](https://discourse.itk.org/user_avatar/discourse.itk.org/lassoan/32/27_2.png) [@lassoan](https://discourse.itk.org/u/lassoan)\
**Post date:** [January 9, 2019, 2:06am UTC](https://discourse.itk.org/t/issues-in-github/1218/16 "2019-01-09T02:06:51Z")

</div>

I’ve reported my first ITK issue via [github](https://github.com/InsightSoftwareConsortium/ITK/issues/388) issue tracker. It was so much easier than finding the issue tracker, look up my username/password, try to remember how to use it (Jira, GitLab, BitBucket, etc. are all slightly different). Probably GitHub’s issue tracker is not a great project management tool, but it makes it very easy to report an error.