> ## Documentation Index
> Fetch the complete documentation index at: https://kb.packfiles.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Issue Page

> The interface for managing migrations.

### Overview

<Frame caption="Warp creates an issue for each repository it finds at the source.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(2)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=d8e3e90ecb8f6591dc4e184ffe2a8fe8" alt="" width="375" data-path="content/media/images/image (2) (1) (1) (1) (1) (1) (1) (1).png" />
</Frame>

Each issue in *Migration HQ* represents a repository, where:.

* The *body* of the issue displays detailed information about the repository, including its status.
* The *comments* act as Warp’s user interface, where you enter commands and get responses.

### Issue Name

When Warp creates an issue for a repository to be migrated, it assigns the issue a name using the following format:

**\[*source*]\[*repository\_name*]**

* *source* represents the source of the repository to be migrated (e.g., Azure DevOps).
* *repository\_name* is the name of the repository, as specified in the source.

Repositories that have not yet been migrated are marked with GitHub’s *Open* indicator...

<Frame caption="Title of an issue for a repository that has not yet been migrated.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/image%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=9c033640ef0864e46c16ed0fb1c48864" alt="" width="375" data-path="content/media/images/image (1) (1) (1) (1) (1) (1) (1) (1) (1) (1).png" />
</Frame>

...and repositories that have been migrated or ignored are marked with GitHub’s *Closed* indicator:

<Frame caption="Title of an issue for a repository that has been migrated or ignored.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(2)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=d2e718283667fe7855ca23d2a1346660" alt="" width="375" data-path="content/media/images/image (2) (1) (1) (1) (1) (1) (1) (1) (1).png" />
</Frame>

### Start of Body

The issue’s body begins with the author attribution. Any issue or comment generated by Warp is attributed to the user **packfiles-warp**, followed by a rough date for when the issue was generated (e.g., “opened last week”):

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(57).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=7fbb7ecfb7e6dbfd754a95323bfa8166" alt="" width="1692" height="102" data-path="content/media/images/image (57).png" />
</Frame>

After the attribution, the first line of the issue’s body specifies the purpose of the issue:

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(58).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=e0de7df6b267f6c8055380c6520fbff5" alt="" width="1692" height="67" data-path="content/media/images/image (58).png" />
</Frame>

The line follows the format “This tracks the migration of the *\[repository\_name]* repository from *\[source\_system]* to GitHub” where:

* *\[repository\_name]* is the name of the repository as it appears in its source system.
* *\[source\_system]* is the name of the system that the repository is being migrated *from* (e.g., Azure DevOps).

#### If the Migration Is Ignored

If the migration is ignored (i.e., manually marked as **Completed** or **Not Planned**), the “⚠️ This Repository Has Been Ignored ⚠️” message appears at the start of the body:

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(59).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=211da9293cbc38c8abf98b6bfdfc4e8e" alt="" width="1788" height="654" data-path="content/media/images/image (59).png" />
</Frame>

The message informs the user that:

* Since the issue was closed manually, its repository will be ignored.
* Because the repository is ignored, Warp will ignore slash commands typed into the comments and will not update the issue’s comments.
* The repository can be “un-ignored” by manually changing its status from **Closed** to **Open**, which can be done at the bottom of the issue page or via the **Mark as** menu in the closed issues list (see [*Issues*](./)).

### Migration Status

<Frame caption="The *Migration Status* section for an issue whose repository has not yet been migrated.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(2)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=b4c461c3601a91656f6a7cb42b5e62c2" alt="" width="1692" height="424" data-path="content/media/images/image (2) (1) (1) (1) (1) (1) (1).png" />
</Frame>

The *Migration Status* section contains:

* The current status of the repository (e.g., “not started”, “complete”).
* A checklist of tasks that need to be completed in order to complete the migration. Warp will automatically check tasks off this list as they are completed.

<Frame caption="The *Migration Status* section for an issue whose repository has been migrated.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(45).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=4f9ec94f06e3832a92c3c8077bc624b6" alt="" width="1692" height="388" data-path="content/media/images/image (45).png" />
</Frame>

### About

<Frame caption="The *About* section.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(3)%20(1)%20(1)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=1f63658748effd89fc0e7cdd2ddee769" alt="" width="1692" height="322" data-path="content/media/images/image (3) (1) (1) (1) (1) (1).png" />
</Frame>

The *About* section, when expanded, lists details about the repository on the source system. It contains:

* The **date** when the last commit to the repository was pushed.
* The **number of commits** made to the repository in the last year.
* The **name and email address** of the repository’s most active contributor.
* The **size** of the repository.

### Source & Destination

<Frame caption="The *Source & Destination* section for an issue whose repository has not yet been migrated.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(4)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=7cb940616b462fdde97c777f90395215" alt="" width="1692" height="439" data-path="content/media/images/image (4) (1) (1) (1).png" />
</Frame>

The *Source & Destination* section, when expanded, provides links to the source and destination repositories. It contains:

* The name and link for the source repository.
* The name of the destination repository, and if the repository has been migrated, the link to the destination repository.

<Frame caption="The *Source & Destination* section for an issue whose repository has been migrated.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(46).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=1b3c8b91dfc3929db6942de30c5853fd" alt="" width="1692" height="332" data-path="content/media/images/image (46).png" />
</Frame>

### Inventory

The *Inventory* section, when expanded, displays information about the migrated repository, providing the date and time when the repository was migrated as well as a link to the destination repository:

<Frame caption="The *Inventory* section for an issue whose repository has been migrated.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(49).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=d372342e5eb5964abf10845d4b2cd650" alt="" width="1692" height="474" data-path="content/media/images/image (49).png" />
</Frame>

In an issue for a repository that hasn’t yet been migrated, the *Repository Content* section simply displays that the repository has not yet been migrated to GitHub:

<Frame caption="The *Inventory* section for an issue whose repository has not yet been migrated.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(48).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=6dc973bc09336f0b93f6b3e4d6127b94" alt="" width="1692" height="374" data-path="content/media/images/image (48).png" />
</Frame>

### Help & Support

<Frame caption="The Help & Support section for an issue.">
  <img src="https://mintcdn.com/packfiles/2Rig8FdmZRZViVPt/content/media/images/image%20(8)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=2Rig8FdmZRZViVPt&q=85&s=c6ac4d185258e3f083f4409ad3a548b9" alt="" width="1692" height="759" data-path="content/media/images/image (8) (1) (1) (1).png" />
</Frame>

The *Help & Support* section appears near the end of the issue’s body. When expanded, it lists the ways you can get help while using Warp.

It provides links to the following resources:

* The Warp **Knowledge Base**.
* GitHub’s Copilot docs (Warp works with Copilot chat — open it and try sending questions to **@packfiles-warp!**).
* The link for **Packfiles Support**.

### End of Body

<Frame caption="The end of an issue’s body.">
  <img src="https://mintcdn.com/packfiles/2Rig8FdmZRZViVPt/content/media/images/image%20(9)%20(1)%20(1).png?fit=max&auto=format&n=2Rig8FdmZRZViVPt&q=85&s=2085fe64a12f87dd90f37590bfd3f64f" alt="" width="1692" height="291" data-path="content/media/images/image (9) (1) (1).png" />
</Frame>

The issue’s body ends with the following:

* GitHub’s **Create sub-issue** / **Add existing issue** and emoji menus.
* Author attribution (once again, any issue or comment created by Warp will be attributed to **packfiles-warp**).
* Any labels for the issue, whether they were added by Warp or a user.
* A rough date for when the issue was generated (e.g., “opened last week”).

### Comments and Slash Commands

<Frame caption="The comments section for an issue.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(50).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=4e9a72fe3c87e1fb4e83e1ad9a96e887" alt="" width="1692" height="579" data-path="content/media/images/image (50).png" />
</Frame>

In any issue created by Warp, comments serve an additional purpose: they’re your interface for issuing migration commands.

Commands to Warp are called **slash commands** because they start with the “slash” (`/`) character. You’ll find the full list of slash commands on the [*Slash Commands* documentation page](../../slash-commands/).

#### Simple Migration Example

Here’s an example of a repository migration.

To migrate a repository, you would open its issue page, scroll to the comments section, and enter the `/migrate` command into the comment box as shown below:

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(51).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=e7bbed0e4fa2dfc74cef8693067c6d22" alt="" width="1692" height="574" data-path="content/media/images/image (51).png" />
</Frame>

Seconds later, Warp will respond with a comment informing you that the migration has started, and that it will notify you when the process has completed:

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(52).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=dd80745cb45a09d621295bda251a3abf" alt="" width="1692" height="338" data-path="content/media/images/image (52).png" />
</Frame>

When the process is complete, Warp will post another comment informing you that the migration was successful. The comment will include a link to the new migrated repository:

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(53).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=ca6338a4251c9cd10994246f212b2eb3" alt="" width="1692" height="341" data-path="content/media/images/image (53).png" />
</Frame>

Warp automatically closes a repository’s issue after it has been migrated. The issue’s “closed” status will be indicated in the issue’s title and in a notice in the comments, which will also provide a rough date for when the issue was closed (e.g., “1 minute ago”):

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(54).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=13272cb1c4ad55c3db14944c82e7589f" alt="" width="1692" height="95" data-path="content/media/images/image (54).png" />
</Frame>

### Ignoring a Repository

**You can choose to ignore repositories that you don’t want to migrate.** You can mark an issue as *ignored* by clicking the **Close issue** button in its comments section...

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(3)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=ffbdb1bfc2391182203477bceea094ba" alt="" width="2330" height="788" data-path="content/media/images/image (3) (1) (1) (1).png" />
</Frame>

...or by checking its box in the closed issues list and selecting **Open** from the **Mark as** menu:

<Frame>
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/image%20(1)%20(1)%20(1)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=e02f7b376dca313c2aee890cfe1e2895" alt="" width="3132" height="776" data-path="content/media/images/image (1) (1) (1) (1) (1) (1).png" />
</Frame>
