# README
toggl-sync
Application to synchronize Toggl entries to Jira.
Logging work on Jira helps visualize if we are focusing on the right things, or if we are spending too much time on other work (meetings, support, etc).
If you use Toggl for time tracking...
... you then have to spend time updating your work logs on Jira, and this is not fun to do.
This small application helps synchronizing all those Toggl entries to Jira, following very simple naming conventions.
Naming conventions
Time entries fall into 2 categories, depending on their Description
:
- Project work: the
Description
starts with a known project prefix (e.g.ENG
). This is the naming convention of Jira tickets. - Overhead work: the
Description
can be anything (e.g.Team catch-up
). These are normally grouped together under some category (e.g.Meetings
). These overhead tickets are helpful to track the time spent on these type of sessions.
Project work can be logged directly, but Overhead work needs extra input from the user (i.e. which Jira ticket should be used to log work against).
toggl-sync
will remember any configuration values provided by the user, so subsequent runs should be smooth and pain-free.