You can find two main concept at Athenian, users and teams. When we are talking about users we are talking about users of the product. When we talk about teams we are talking about the teams that compose your organization.
Proper configuration of teams is critical because it will be one of the dimensions you'll constantly use to filter data. When you connect GitHub to Athenian we bootstrap your teams based on GitHub teams, but afterwards you need to manually or programmatically change your teams to better reflect your organizational changes.
To do it manually you need to
Go to your teams' page;
Create new teams or edit the existing ones on this page;
If you use Jira, ensure the team members are properly linked to Jira;
To do it programmatically
If you need continuously change or create your teams, or to do a bulk operation, you can do this programmatically by using our API and calling it whenever your system which is the master repository of data gets updated.
To do that you need to:
Create a small script that uses curl, or another alternative, to call our create or update API endpoints (please pay special attention to the update endpoint as you need to pass the whole team and not only the new members of the team);
To create hierarchies
Create a hierarchical team structure with multiple layers, like the one above, by following these steps:
Go to your teams' page;
Go to edit under the team menu;
Select your parent team;