Skip to main content

Issues and PRs > Author

Tom Williams avatar
Written by Tom Williams
Updated over a week ago

Dataset: Issues & Pull Requests

Entity: Pull Requests, Issues

Field ID: author_username

Type: Text

Description: The username of the person who created the issue or pull request. Note that usernames are app-specific.

Source: App

Transformation logic: N/A

From:

Github (PRs, Issues)

author

Gitlab (PRs, Issues)

author

Bitbucket (PRs)

author

Azure DevOps (PRs, Issues)

createdBy

Jira (Issues)

creator

ClickUp (Issues)

creator

Trello (Issues)

author

Reporting Use Cases

The author_username field is essential for understanding the origin of work and analyzing contribution patterns across your team and projects. As a text field, it is most commonly used for filtering data and as a dimension for grouping results in reports.

  • Filtering and Personalization: You can easily scope your widgets to focus on work created by specific individuals or groups.

    • User-Specific Reports: Create reports that only show issues or pull requests created by a particular person using a filter like Author = "jane.doe".

    • Personal Dashboards: Use the is me operator to build dynamic widgets that show only the work initiated by the person viewing the dashboard.

    • Excluding Automated Work: A common use case is to filter out automated contributions by excluding authors that match a certain pattern, such as Author !~ "bot".

  • Contribution Analysis: Using Author as a dimension in charts allows you to visualize who is creating work and what kind of work they are creating.

    • Work Distribution: A bar or pie chart with author_username as the dimension and COUNT() as the metric can quickly show who is opening the most issues or creating the most pull requests.

    • Contribution Type: By adding a second dimension, such as the issue type or labels, you can analyze the nature of contributions. For example, you could create a stacked bar chart to see the breakdown of bugs versus feature requests submitted by each author.

  • Aggregated Metrics: You can also use this field within metrics to calculate higher-level KPIs.

    • Contributor Count: The COUNT_DISTINCT(author_username) formula will tell you the number of unique contributors in a given period, which is a great way to measure engagement and team growth.

    • Anonymized Reporting: If you need to report on trends without showing individual names, you can use hashing functions like SHA1(author_username) to anonymize the data while still being able to group by unique individuals.

Did this answer your question?