[
https://issues.apache.org/jira/browse/LUCENE-10557?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17558834#comment-17558834
]
Tomoko Uchida edited comment on LUCENE-10557 at 6/26/22 4:09 AM:
-----------------------------------------------------------------
Basic requirements for migrating old issues that were confirmed so far:
* (/) All "texts" (issue descriptions and comments) are migrated.
* (/) All major metadata (issue types, versions, components, etc.) are
preserved as issue labels.
* (/) Issue and comment original created timestamps are preserved.
* (x) Issue and comment original reporters/authors are NOT preserved.
** There's no way to modify GitHub issue/comment reporters/authors. Still can
be noted in plain texts - @ mentions or full name
* (!) Jira markup is converted into Markdown for rendering.
** There are many conversion errors and need close investigation.
* (x) "attachments" (patches, images, etc) cannot be migrated with basic
GitHub API functionality.
** There could be workarounds; e.g. save them in another github repo and
rewrite attachment links to refer to them.
* (/) Issue assigners are preserved if the corresponding GitHub account is
given.
* (/) All Jira cross-issue links (LUCENE-XXXX) are mapped into GitHub
cross-links (#YYYY).
* (/) Jira user IDs are mapped into GitHub account mentions. NOTE: Mapping
should be prepared/generated.
* (!) Mentions to Jira IDs in issue descriptions or comments are possibly
mapped to GitHub mentions - haven't tried yet.
Current consideration to me is how to handle attachments. While there should be
workarounds, it'll be a major work. If it's a "minimum" requirements,
personally I think we shouldn't proceed with the migration.
was (Author: tomoko uchida):
Basic requirements for migrating old issues that were confirmed so far:
* (/) All "texts" (issue descriptions and comments) are migrated.
* (/) All major metadata (issue types, versions, components, etc.) are
preserved as issue labels.
* (/) Issue and comment original created timestamps are preserved.
* (x) Issue and comment original reporters/authors are NOT preserved.
** There's no way to modify GitHub issue/comment reporters/authors. Still can
be noted in plain texts - @ mentions or full name
* (!) Jira markup is converted into Markdown for rendering.
** There are many conversion errors and need close investigation.
* (x) "attachments" (patches, images, etc) cannot be migrated with basic
GitHub API functionality.
** There could be workarounds; e.g. save them in another github repo and
rewrite attachment links to refer to them.
* (/) Issue assigners are preserved if the corresponding GitHub account is
given.
* (/) All Jira cross-issue links (LUCENE-XXXX) are mapped into GitHub
cross-links (#YYYY).
* (/) Jira user IDs are mapped into GitHub account mentions. NOTE: Mapping
should be prepared/generated.
* (!) Mentions to Jira IDs in issue descriptions or comments are possibly
mapped to GitHub mentions - haven't tried yet.
> Migrate to GitHub issue from Jira
> ---------------------------------
>
> Key: LUCENE-10557
> URL: https://issues.apache.org/jira/browse/LUCENE-10557
> Project: Lucene - Core
> Issue Type: Sub-task
> Reporter: Tomoko Uchida
> Assignee: Tomoko Uchida
> Priority: Major
>
> A few (not the majority) Apache projects already use the GitHub issue instead
> of Jira. For example,
> Airflow: [https://github.com/apache/airflow/issues]
> BookKeeper: [https://github.com/apache/bookkeeper/issues]
> So I think it'd be technically possible that we move to GitHub issue. I have
> little knowledge of how to proceed with it, I'd like to discuss whether we
> should migrate to it, and if so, how to smoothly handle the migration.
> The major tasks would be:
> * (/) Get a consensus about the migration among committers
> * Choose issues that should be moved to GitHub
> ** Discussion thread
> [https://lists.apache.org/thread/1p3p90k5c0d4othd2ct7nj14bkrxkr12]
> ** -Conclusion for now: We don't migrate any issues. Only new issues should
> be opened on GitHub.-
> ** Write a prototype migration script - the decision could be made on that.
> Things to consider:
> *** version numbers - labels or milestones?
> *** add a comment/ prepend a link to the source Jira issue on github side,
> *** add a comment/ prepend a link on the jira side to the new issue on
> github side (for people who access jira from blogs, mailing list archives and
> other sources that will have stale links),
> *** convert cross-issue automatic links in comments/ descriptions (as
> suggested by Robert),
> *** strategy to deal with sub-issues (hierarchies),
> *** maybe prefix (or postfix) the issue title on github side with the
> original LUCENE-XYZ key so that it is easier to search for a particular issue
> there?
> *** how to deal with user IDs (author, reporter, commenters)? Do they have
> to be github users? Will information about people not registered on github be
> lost?
> *** create an extra mapping file of old-issue-new-issue URLs for any
> potential future uses.
> *** what to do with issue numbers in git/svn commits? These could be
> rewritten but it'd change the entire git history tree - I don't think this is
> practical, while doable.
> * Build the convention for issue label/milestone management
> ** Do some experiments on a sandbox repository
> [https://github.com/mocobeta/sandbox-lucene-10557]
> ** Make documentation for metadata (label/milestone) management
> * Enable Github issue on the lucene's repository
> ** Raise an issue on INFRA
> ** (Create an issue-only private repository for sensitive issues if it's
> needed and allowed)
> ** Set a mail hook to
> [issues@lucene.apache.org|mailto:issues@lucene.apache.org] (many thanks to
> the general mail group name)
> * Set a schedule for migration
> ** Give some time to committers to play around with issues/labels/milestones
> before the actual migration
> ** Make an announcement on the mail lists
> ** Show some text messages when opening a new Jira issue (in issue template?)
--
This message was sent by Atlassian Jira
(v8.20.7#820007)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org
