GitHub Projects Support
Last updated
Last updated
is GitHub's flexible and configurable planning and task management system. Logilica supports GitHub Projects boards by importing them as Planning data.
Given the highly customisable nature of GitHub Projects, Logilica uses a number of heuristics and rules to map and model planning data from GitHub Projects.
These rules are based on matching either on , or on a within an issue. The values of these fields or labels are then mapped into the Logilica data model. Unless stated otherwise, all matching is done case-insensitively.
GitHub Project Issue types are detected in two ways:
A label on the issue that begins with kind/
or type/
the text following the /
is taken as the issue type name.
The value of a custom field named either kind
or type
is taken as the issue type name.
Note: when both these are present, the custom field takes precedence
Logilica matches against GitHub's issue status field and maps this internally to one of three states
Todo - any item whose issue state is unset or matches todo
or to do
In Progress - any item whose issue state matches in progress
or in review
Done - any item whose issue state matches done
Logilica detects Sprints through the values used in a custom within imported issues. The custom iteration field must be named sprint
.
In addition to the above, the below fields are also supported:
Priority - matches the value that appears after a label that starts with priority/
or a custom field on an issue with the name priority
.
Story Points - matches on a custom field within an issue named story point
For Logilica to most accurately reflect the GitHub Projects data, we recommend following a few best practices in your GitHub Projects setup:
Make sure you are using the iteration field
to define sprints.
Use labels or custom fields to define issue types with the convention explained .
Use issue status such as todo
, in progress
and done
as explained .
Define story points and priorities as described .
For more questions consult the GitHub Projects or connect with your Logilica support representative.