Migration of OPS4J projects from Jira to Github

[Grzegorz Grzybek]

Hello

I'd like to let you know that I've migrated these projects from OPS4J Jira to Github:

 - PAX TRANSX: https://github.com/ops4j/org.ops4j.pax.transx/issues?q=is%3Aissue+is%3Aall

 - PAX JMS: https://github.com/ops4j/org.ops4j.pax.jms/issues?q=is%3Aissue+is%3Aall

 - PAX JDBC: https://github.com/ops4j/org.ops4j.pax.jdbc/issues?q=is%3Aissue+is%3Aall

These issues are taken into account:

 - Jira components, statuses, resolutions, issue types and labels are converted to Github labels

 - Jira versions are converted to Github milestones

 - The Jira fields that couldn't be mapped, are added below "---" line in the body of the GitHub issue (like vote/watch count, affected versions, fixed versions and attachments)

 - Attachment links still point to Jira, but inline images are properly displayed

 - Jira issues received "famous last comments" pointing to relevant Github issues

 - Jira screen schemes were migrated to a scheme, were you can't create new issue

 - HTML is converted to GitHub flavored markdown

 - all @xxx values (like @Service or @param) occurrences are properly quoted in backticks to prevent unnecessary GitHub mentions

One remaining thing to do, which is almost ready is the conversion of Jira issue references to GitHub issue references - but I want to do proper cross references between Pax projects at GitHub - not only within single project.

I was inspired by https://spring.io/blog/2019/01/15/spring-framework-s-migration-from-jira-to-github-issues blog post which made me aware of few things.

The biggest problem I see is that all the comments and all the issues are created by me... Even if the creation dates are preserved, I simply can't (and don't want to) get proper Jira - GitHub user mapping.

In case of Spring migration, they created special GitHub user, but I can't create another one using my gmail address. And I don't want to create weird fake addresses.

You can check quite raw tools at https://github.com/ops4j/org.ops4j.tools/blob/master/jira2github/data/readme.adoc

Before I proceed with "bigger" projects like Pax Logging or Pax Web, I'd appreciate your feedback.

kind regards

Grzegorz Grzybek

[Grzegorz Grzybek]

Hello

Thanks to Jürgen Schmid, I was able to set up "ops4j-issues" GitHub account with my current gmail address. I'll continue (if there are no objections) with the migration using this account.

kind regards

Grzegorz Grzybek

[Grzegorz Grzybek]

Hello

After a little problem, where my "ops4j-issues" Github account was suspended, I finally got an answer from Github Support and the account was verified.

I've fully finished the migration of PAXJMS project - completing the migration with issue references. As with Spring projects, I've simply added an <hr> separated section in the body of the issue, which looks like this:

**Referenced issues**

**relates to:**

* ops4j/org.ops4j.pax.jdbc#104 - NPE on oracle thin client with TNS key-value syntax in jdbc url [PAXJDBC-147]

Within given project, the link is just e.g., "#104", but I've added some checks that allow me to cross reference between already migrated projects.

See an example of an issue with links: https://github.com/ops4j/org.ops4j.pax.jms/issues/48

kind regards

Grzegorz Grzybek

wt., 9 lut 2021 o 15:51 Matt Pavlovich <matt...@gmail.com> napisał(a):

Grzegorz-

Nice work!  I think having the projects on GitHub will reduce efforts of the core contributors and will make it more accessible for new contributors as well.

-Matt Pavlovich

>> *The biggest problem I see is that all the comments and all the issues are

>> created by me... Even if the creation dates are preserved, I simply can't

>> (and don't want to) get proper Jira - GitHub user mapping.*