Skip to content

MIGRATION: Evaluate image and attachment handling #14513

Closed

Description

@toddfarmer

ASF Jira issues may have attached content, including images displayed inline in comments. This issue is a marker to evaluate how that content may migrate, and whether additional work may be required. Issue attachments may simply be referenced in an added comment, indicating attachments exist and can be retrieved from the source issue. Missing inline images (if not handled by migration) may be a bit more challenging to handle usefully.

Activity

  1. toddfarmer commented on Nov 14, 2022

    @toddfarmer
    ContributorAuthor

    By default, inline images render as broken image links in migrated content - see this example:

    image

  2. toddfarmer commented on Nov 14, 2022

    @toddfarmer
    ContributorAuthor

    By adding some additional translation, it's possible to direct the inline image/attachment links in the migrated content back to the ASF Jira-hosted content. See this example.

    Note that this points back to the original ASF Jira issue content, and the actual attachment has not been migrated to GitHub. This also means that if ASF Jira content is removed, inline content such as this will break.

  3. toddfarmer commented on Nov 14, 2022

    @toddfarmer
    ContributorAuthor
  4. toddfarmer commented on Nov 14, 2022

    @toddfarmer
    ContributorAuthor

    It would be trivially easy to list the attachments with links to the content found in ASF Jira (not copying content into GitHub). Do we have strong feelings on needing to bring this referenced content over to GitHub itself, or can we allow migrated issues to point back to the content in ASF Jira? Because ASF Jira is world-readable, the content itself isn't restricted to registered Jira users. Any new attachments added would obviously end up in GitHub.

  5. toddfarmer commented on Nov 15, 2022

    @toddfarmer
    ContributorAuthor

    Unless there are objections, I plan to:

    1. Fix inline image links to point to the ASF Jira-hosted content from the source issue, without migrating/copying any content.
    2. Add a list of issue attachments at time of migration to the issue description with links to the ASF Jira issue content (again, without copying any of that content to GitHub issues).

    Both are demonstrated in this example issue: https://github.com/toddfarmer/test_import/issues/313

  6. jorisvandenbossche commented on Nov 16, 2022

    @jorisvandenbossche
    Member

    Sounds good!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions