Links
Comment on page

FAQs and troubleshooting

Organization is not appearing in Avion

GitHub has added an additional layer of security for Organizations. You need to open up access in the Organization settings:

What Happens When I...

In Avion
In GitHub
Action
Result
Update story
We will be update the issue where applicable, assuming that the story has been pushed or imported
Delete story
We will close the issue
Update release name
We will update the milestone name. Only applies to repo projects
Archive release
Nothing will happen in GitHub
Delete a release
The milestone and issues will be deleted in Github
Update story state
We will update the project card column according to what is mapped in Avion
Action
Result
Delete issue
If the story has been pushed to GitHub, we will unsync the story and it will remain in Avion. Feel free to delete it from Avion if you don't need it
Delete project card
If the story has been pushed to GitHub, we will unsync the story and it will remain in Avion. Feel free to delete it from Avion if you don't need it. The issue will remain in GitHub
Close issue
Nothing will happen in Avion
Delete milestone
If a release exists in Avion for the milestone, all synced stories will be moved to unplanned. The release will not be deleted, but will be unsynced (still in Avion). Only applies to repo projects
Archive project card
Nothing will happen in Avion
Close milestone
Nothing will happen in Avion. Only applies to repo projects
Update issue
If the story has been pushed to GitHub, we will update the story in Avion
Update issue size label
We will attempt to update the size in Avion
Remove issue from milestone
We will move the story to the Unplanned release in Avion. Only applies to repo projects
Change issue's milestone
We will attempt to update the story with the corresponding release in Avion. Only applies to repo projects
Change project card's column
We will update the status of the story in Avion inline with your state mappings
Update milestone name
We will attempt to update the corresponding release's name in Avion. Only applies to repo projects
Transfer issue to another repo
We will unsync the issue, but the story will remain in Avion
Delete repo
If you have synced to a repo-based project, we will remove the integration. If you have synced to an organisation-based project, we will update the list of repos in Avion and unsync any stories that came from that repo

Avoiding milestone name clashes

When synced to a repo-based project, you cannot use the same name for two Avion releases and push them, as GitHub has a clash restriction on milestone names.

Importing closed issues

Please note that we do not import closed issues or milestones. To import open issues, please ensure that there is a project card associated with the issue. To import open milestones, please ensure there is at least one issue in the milestone.

Adding a new organization

If you previously sync up Avion to GitHub, but want to add a new integration for another story map with an organization that is not getting recognised, you may need to grant privileges to Avion. You can do this by going to https://github.com/settings/applications when signed in as the user in question and granting the appropriate organization by clicking Grant:

Syncing a GitHub project to multiple Avion story maps

This is supported in Avion. It can be a useful way to visualise different user journey setups. In particular, this works well with organization projects, as you can define different release plans and compare these plans beside each other.

Where is my repo/organization in the list?

  • Ensure that you are an owner of the repo
  • Ensure that you are an admin of the repo, if the repo is owned by an organization
  • Ensure that you are an owner of the organization, if you want to sync with an organization project
  • Ensure that there is a project with columns in the repo or organization

Are GitHub's milestones supported?

Yes, but only for repo-based projects.

Can I push user stories to multiple/different repos?

Yes, but only for organization-based projects or ZenHub workspace integrations.

Labels not syncing

if you have optionally selected to sync Avion tags or releases to labels and are using the all-new project experience, labels should sync automatically, whichever tool you update them in. There is one exception. If you edit a label from the GitHub project item page, Avion will not update. This is a shortcoming with GitHub's webhooks. To avoid this data sync issue, update labels from the issue screen in GitHub, or from Avion.

Last modified 1yr ago