diff --git a/frontend/app/components/modules/project/components/contributors/active-contributors.vue b/frontend/app/components/modules/project/components/contributors/active-contributors.vue index f8dbb97ef..5a832a402 100644 --- a/frontend/app/components/modules/project/components/contributors/active-contributors.vue +++ b/frontend/app/components/modules/project/components/contributors/active-contributors.vue @@ -2,8 +2,13 @@

Active contributors

- Active contributor is an individual performing tasks such as commits, issues, or pull requests - during the selected time period. + Active contributor is an individual who performed activities such as commits, issues, or + pull requests during the selected time period. + Learn more


@@ -67,6 +72,7 @@ import { formatNumber } from '~/components/shared/utils/formatter'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; import { dateOptKeys } from '~/components/modules/project/config/date-options'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository, selectedTimeRangeKey, customRangeGranularity diff --git a/frontend/app/components/modules/project/components/contributors/active-organizations.vue b/frontend/app/components/modules/project/components/contributors/active-organizations.vue index 84691bef0..58bfa8a48 100644 --- a/frontend/app/components/modules/project/components/contributors/active-organizations.vue +++ b/frontend/app/components/modules/project/components/contributors/active-organizations.vue @@ -2,8 +2,13 @@

Active organizations

- Active organization is an organization performing tasks such as commits, issues, or pull - requests during the selected time period. + Organizations that had at least one activity during the selected period, carried out by contributors on their + behalf. + Learn more


@@ -67,6 +72,7 @@ import { formatNumber } from '~/components/shared/utils/formatter'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; import { dateOptKeys } from '~/components/modules/project/config/date-options'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository, selectedTimeRangeKey, customRangeGranularity diff --git a/frontend/app/components/modules/project/components/contributors/contributor-dependency.vue b/frontend/app/components/modules/project/components/contributors/contributor-dependency.vue index ac3230a01..838b51a41 100644 --- a/frontend/app/components/modules/project/components/contributors/contributor-dependency.vue +++ b/frontend/app/components/modules/project/components/contributors/contributor-dependency.vue @@ -2,8 +2,13 @@

Contributor dependency

- Distribution of contributions among different contributors, highlighting key individuals who - are actively involved in the project. + Distribution of contributions among different contributors, highlighting key individuals who are actively + involved in the project during the selected time period. + Learn more


@@ -64,6 +69,7 @@ import LfxAvatarGroup from '~/components/uikit/avatar-group/avatar-group.vue'; import LfxAvatar from '~/components/uikit/avatar/avatar.vue'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository } = storeToRefs(useProjectStore()) diff --git a/frontend/app/components/modules/project/components/contributors/contributors-leaderboard.vue b/frontend/app/components/modules/project/components/contributors/contributors-leaderboard.vue index a06a40ed2..96f3ede92 100644 --- a/frontend/app/components/modules/project/components/contributors/contributors-leaderboard.vue +++ b/frontend/app/components/modules/project/components/contributors/contributors-leaderboard.vue @@ -2,8 +2,12 @@

Contributors leaderboard

- It ranks contributors based on the number of code commits, pull requests, issues closed, and - other metrics representing their relative activity levels and impact on the project. + Contributor ranking based on the number of activities performed and the impact on the project. + Learn more


@@ -38,6 +42,7 @@ import type { ContributorLeaderboard } from '~~/types/contributors/responses.typ import LfxCard from '~/components/uikit/card/card.vue'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository } = storeToRefs(useProjectStore()) diff --git a/frontend/app/components/modules/project/components/contributors/geographical-distribution.vue b/frontend/app/components/modules/project/components/contributors/geographical-distribution.vue index 46320ba7e..259837eb9 100644 --- a/frontend/app/components/modules/project/components/contributors/geographical-distribution.vue +++ b/frontend/app/components/modules/project/components/contributors/geographical-distribution.vue @@ -3,7 +3,13 @@

Geographical distribution

- Distribution of contributors based on geographical location. + Distribution of contributors and organizations based on geographical location at the time of their contributions + during the selected period. + Learn more


@@ -89,6 +95,7 @@ import { getGeoMapChartConfig } from '~/components/uikit/chart/configs/geo-map.c import { formatNumber } from '~/components/shared/utils/formatter'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; +import { links } from '~/config/links'; const metricOptions = metricsOptions; diff --git a/frontend/app/components/modules/project/components/contributors/organization-dependency.vue b/frontend/app/components/modules/project/components/contributors/organization-dependency.vue index 7b867fbcc..0cd68a058 100644 --- a/frontend/app/components/modules/project/components/contributors/organization-dependency.vue +++ b/frontend/app/components/modules/project/components/contributors/organization-dependency.vue @@ -2,8 +2,13 @@

Organization dependency

- Distribution of contributions by different organizations to the project. A project is at risk - if only a few organizations are responsible for a large portion of the total activities. + Distribution of contributions across different organizations, whose contributors were actively involved in the + project during the selected period. + Learn more


@@ -64,6 +69,7 @@ import LfxAvatarGroup from '~/components/uikit/avatar-group/avatar-group.vue'; import LfxAvatar from '~/components/uikit/avatar/avatar.vue'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository } = storeToRefs(useProjectStore()) diff --git a/frontend/app/components/modules/project/components/contributors/organizations-leaderboard.vue b/frontend/app/components/modules/project/components/contributors/organizations-leaderboard.vue index de022b604..2d1b9941b 100644 --- a/frontend/app/components/modules/project/components/contributors/organizations-leaderboard.vue +++ b/frontend/app/components/modules/project/components/contributors/organizations-leaderboard.vue @@ -2,8 +2,13 @@

Organizations leaderboard

- It ranks contributors based on the number of code commits, pull requests, issues closed, and - other metrics representing their relative activity levels and impact on the project. + Organization ranking based on the number of activities performed by contributors on their behalf and the impact on + the project. + Learn more


@@ -38,6 +43,7 @@ import type { OrganizationLeaderboard } from '~~/types/contributors/responses.ty import LfxCard from '~/components/uikit/card/card.vue'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository } = storeToRefs(useProjectStore()) diff --git a/frontend/app/components/modules/project/components/contributors/retention.vue b/frontend/app/components/modules/project/components/contributors/retention.vue index 8115bdef7..8bb7c17d2 100644 --- a/frontend/app/components/modules/project/components/contributors/retention.vue +++ b/frontend/app/components/modules/project/components/contributors/retention.vue @@ -2,7 +2,12 @@

Retention

- Rate at which contributors join and remain active participants of the project. + Rate at which contributors and organizations continued contributing to the project during the selected period. + Learn more


@@ -60,6 +65,7 @@ import { lineGranularities } from '~/components/shared/types/granularity'; import type { Retention } from '~~/types/contributors/responses.types'; import { dateOptKeys } from '~/components/modules/project/config/date-options'; import type { Granularity } from '~~/types/shared/granularity'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository, selectedTimeRangeKey, customRangeGranularity diff --git a/frontend/app/components/modules/project/components/development/active-days.vue b/frontend/app/components/modules/project/components/development/active-days.vue index d7e7930fe..b09205ed6 100644 --- a/frontend/app/components/modules/project/components/development/active-days.vue +++ b/frontend/app/components/modules/project/components/development/active-days.vue @@ -4,8 +4,7 @@ Active days

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + (TBD)


diff --git a/frontend/app/components/modules/project/components/development/average-time-to-merge.vue b/frontend/app/components/modules/project/components/development/average-time-to-merge.vue index ad4753a31..b89d4d511 100644 --- a/frontend/app/components/modules/project/components/development/average-time-to-merge.vue +++ b/frontend/app/components/modules/project/components/development/average-time-to-merge.vue @@ -4,8 +4,12 @@ Average time to merge

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + Average time taken for pull requests to be merged during the selected period. + Learn more


@@ -68,6 +72,7 @@ import { isEmptyData } from '~/components/shared/utils/helper'; import { barGranularities } from '~/components/shared/types/granularity'; import { dateOptKeys } from '~/components/modules/project/config/date-options'; import type { Granularity } from '~~/types/shared/granularity'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository, selectedTimeRangeKey, customRangeGranularity diff --git a/frontend/app/components/modules/project/components/development/code-review-engagement.vue b/frontend/app/components/modules/project/components/development/code-review-engagement.vue index a23f7b660..9e0d74941 100644 --- a/frontend/app/components/modules/project/components/development/code-review-engagement.vue +++ b/frontend/app/components/modules/project/components/development/code-review-engagement.vue @@ -4,8 +4,12 @@ Code review engagement

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + Level of contributors involvement and participation in code review activities during the selected period. + Learn more


@@ -69,6 +73,7 @@ import LfxTabs from '~/components/uikit/tabs/tabs.vue'; import { formatNumber } from '~/components/shared/utils/formatter'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository } = storeToRefs(useProjectStore()); diff --git a/frontend/app/components/modules/project/components/development/contributions-outside-work-hours.vue b/frontend/app/components/modules/project/components/development/contributions-outside-work-hours.vue index bc4499982..9c1bd35ce 100644 --- a/frontend/app/components/modules/project/components/development/contributions-outside-work-hours.vue +++ b/frontend/app/components/modules/project/components/development/contributions-outside-work-hours.vue @@ -4,8 +4,13 @@ Contributions outside work hours

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + Contributors’ activity patterns focused on contributions performed during non-business hours and weekends during + the selected period. + Learn more


@@ -101,6 +106,7 @@ import { getScatterChartConfig } from '~/components/uikit/chart/configs/scatter. import { formatNumber } from '~/components/shared/utils/formatter'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository } = storeToRefs(useProjectStore()) diff --git a/frontend/app/components/modules/project/components/development/issues-resolution.vue b/frontend/app/components/modules/project/components/development/issues-resolution.vue index 6d596ff7d..cf11f2670 100644 --- a/frontend/app/components/modules/project/components/development/issues-resolution.vue +++ b/frontend/app/components/modules/project/components/development/issues-resolution.vue @@ -4,8 +4,12 @@ Issues resolution

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + Comparison between total number of issues vs. closed issues during the selected time period. + Learn more


@@ -102,6 +106,7 @@ import { isEmptyData } from '~/components/shared/utils/helper'; import { lineGranularities } from '~/components/shared/types/granularity'; import { dateOptKeys } from '~/components/modules/project/config/date-options'; import type { Granularity } from '~~/types/shared/granularity'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository, selectedTimeRangeKey, customRangeGranularity diff --git a/frontend/app/components/modules/project/components/development/merge-lead-time.vue b/frontend/app/components/modules/project/components/development/merge-lead-time.vue index b31102e56..a3f3471ce 100644 --- a/frontend/app/components/modules/project/components/development/merge-lead-time.vue +++ b/frontend/app/components/modules/project/components/development/merge-lead-time.vue @@ -4,8 +4,12 @@ Merge lead time

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + Average time taken for pull requests to be raised, reviewed, accepted and merged during the selected period. + Learn more


@@ -82,6 +86,7 @@ import { formatNumber } from '~/components/shared/utils/formatter'; import type { Summary } from '~~/types/shared/summary.types'; import { useProjectStore } from "~/components/modules/project/store/project.store"; import { isEmptyData } from '~/components/shared/utils/helper'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository } = storeToRefs(useProjectStore()) diff --git a/frontend/app/components/modules/project/components/development/pull-requests.vue b/frontend/app/components/modules/project/components/development/pull-requests.vue index 4820cefaf..67195fa12 100644 --- a/frontend/app/components/modules/project/components/development/pull-requests.vue +++ b/frontend/app/components/modules/project/components/development/pull-requests.vue @@ -4,8 +4,12 @@ Pull requests

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + Comparison between opened and merged (or closed) pull requests during the selected period. + Learn more


@@ -108,6 +112,7 @@ import { isEmptyData } from '~/components/shared/utils/helper'; import { barGranularities } from '~/components/shared/types/granularity'; import { dateOptKeys } from '~/components/modules/project/config/date-options'; import type { Granularity } from '~~/types/shared/granularity'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository, selectedTimeRangeKey, customRangeGranularity diff --git a/frontend/app/components/modules/project/components/development/review-time-by-pull-request-size.vue b/frontend/app/components/modules/project/components/development/review-time-by-pull-request-size.vue index 5091a31a2..d77e8df13 100644 --- a/frontend/app/components/modules/project/components/development/review-time-by-pull-request-size.vue +++ b/frontend/app/components/modules/project/components/development/review-time-by-pull-request-size.vue @@ -4,8 +4,12 @@ Review time by pull request size

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + Average time taken to review pull requests, sorted by number of code line changes during the selected period. + Learn more


@@ -53,6 +57,7 @@ import LfxCard from '~/components/uikit/card/card.vue'; import LfxProgressBar from '~/components/uikit/progress-bar/progress-bar.vue'; import { isEmptyData } from '~/components/shared/utils/helper'; import { useProjectStore } from "~/components/modules/project/store/project.store"; +import { links } from '~/config/links'; const route = useRoute(); const { startDate, endDate, selectedRepository } = storeToRefs(useProjectStore()); diff --git a/frontend/app/components/modules/project/components/development/wait-time-first-review.vue b/frontend/app/components/modules/project/components/development/wait-time-first-review.vue index 9b2d93fb5..aa8b0945e 100644 --- a/frontend/app/components/modules/project/components/development/wait-time-first-review.vue +++ b/frontend/app/components/modules/project/components/development/wait-time-first-review.vue @@ -4,8 +4,12 @@ Wait time for 1st review

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + Average time taken between pull request submission and its first review during the selected period. + Learn more


@@ -68,6 +72,7 @@ import { isEmptyData } from '~/components/shared/utils/helper'; import { barGranularities } from '~/components/shared/types/granularity'; import { dateOptKeys } from '~/components/modules/project/config/date-options'; import type { Granularity } from '~~/types/shared/granularity'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository, selectedTimeRangeKey, customRangeGranularity diff --git a/frontend/app/components/modules/project/components/popularity/forks.vue b/frontend/app/components/modules/project/components/popularity/forks.vue index b888e8ba1..4426acc6a 100644 --- a/frontend/app/components/modules/project/components/popularity/forks.vue +++ b/frontend/app/components/modules/project/components/popularity/forks.vue @@ -4,8 +4,12 @@ Forks

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + New forks (copies) of the project repositories during the selected time period. + Learn more


@@ -77,6 +81,7 @@ import { useProjectStore } from "~/components/modules/project/store/project.stor import { isEmptyData } from '~/components/shared/utils/helper'; import { dateOptKeys } from '~/components/modules/project/config/date-options'; import type { Granularity } from '~~/types/shared/granularity'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository, selectedTimeRangeKey, customRangeGranularity diff --git a/frontend/app/components/modules/project/components/popularity/stars.vue b/frontend/app/components/modules/project/components/popularity/stars.vue index 36b6fe9d2..a01723b9a 100644 --- a/frontend/app/components/modules/project/components/popularity/stars.vue +++ b/frontend/app/components/modules/project/components/popularity/stars.vue @@ -4,8 +4,12 @@ Stars

- Active contributor is an individual performing tasks such as commits, - issues, or pull requests during the selected time period. + New stars added to the project repositories during the selected time period. + Learn more


@@ -77,6 +81,7 @@ import { useProjectStore } from "~/components/modules/project/store/project.stor import { isEmptyData } from '~/components/shared/utils/helper'; import { dateOptKeys } from '~/components/modules/project/config/date-options'; import type { Granularity } from '~~/types/shared/granularity'; +import { links } from '~/config/links'; const { startDate, endDate, selectedRepository, selectedTimeRangeKey, customRangeGranularity diff --git a/frontend/app/components/modules/project/views/contributors.vue b/frontend/app/components/modules/project/views/contributors.vue index 21b8bae29..76e12836c 100644 --- a/frontend/app/components/modules/project/views/contributors.vue +++ b/frontend/app/components/modules/project/views/contributors.vue @@ -1,7 +1,7 @@ diff --git a/frontend/app/components/modules/project/views/development.vue b/frontend/app/components/modules/project/views/development.vue index b3b7c2434..c782bc6f9 100644 --- a/frontend/app/components/modules/project/views/development.vue +++ b/frontend/app/components/modules/project/views/development.vue @@ -1,14 +1,14 @@ diff --git a/frontend/app/components/modules/project/views/popularity.vue b/frontend/app/components/modules/project/views/popularity.vue index eaf7cbf6d..53d0c1987 100644 --- a/frontend/app/components/modules/project/views/popularity.vue +++ b/frontend/app/components/modules/project/views/popularity.vue @@ -1,14 +1,14 @@ diff --git a/frontend/app/config/links.ts b/frontend/app/config/links.ts new file mode 100644 index 000000000..79f278ecc --- /dev/null +++ b/frontend/app/config/links.ts @@ -0,0 +1,3 @@ +export const links = { + learnMore: 'https://docs.linuxfoundation.org/lfx/insights' +};