diff --git a/docs/source/rest-api/spec.yml b/docs/source/rest-api/spec.yml index a24d16410f..a505854a8a 100644 --- a/docs/source/rest-api/spec.yml +++ b/docs/source/rest-api/spec.yml @@ -1596,13 +1596,13 @@ paths: type: array tags: - experimental - /repo-groups/:repo_group_id/open-issues-count: + /repo-groups/:repo_group_id/code-changes: get: - description: 'Count of open issues. ' + description: 'Time series of number of commits during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md - operationId: Open Issues Count (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes.md + operationId: Code Changes (Repo Group) parameters: - description: Repository Group ID in: path @@ -1610,33 +1610,54 @@ paths: schema: type: string type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: + commit_count: + description: 'Example: 173' + type: integer date: - description: 'Example: 2017-09-11T00:00:00.000Z' + description: 'Example: 2018-01-01T00:00:00.000Z' type: string - open_count: - description: 'Example: 1' + repo_id: + description: 'Example: 21337' type: integer - rg_name: - description: 'Example: Netflix' + repo_name: + description: 'Example: graphql-wg' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/closed-issues-count: + /repos/:repo_id/code-changes: get: - description: 'Count of closed issues. ' + description: 'Time series number of commits during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md - operationId: Closed Issues Count (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes.md + operationId: Code Changes (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: @@ -1648,31 +1669,49 @@ paths: schema: type: string type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: - closed_count: - description: 'Example: 26' + commit_count: + description: 'Example: 90' type: integer date: - description: 'Example: 2018-11-26T00:00:00.000Z' + description: 'Example: 2015-01-01T00:00:00.000Z' + type: string + repo_name: + description: 'Example: graphql' type: string - repo_id: - description: 'Example: 21681' - type: integer type: array tags: - evolution - /repo-groups/:repo_group_id/code-changes: + /repo-groups/:repo_group_id/code-changes-lines: get: - description: 'Time series of number of commits during a certain period. ' + description: 'Time series of lines added and removed during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes.md - operationId: Code Changes (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes_Lines.md + operationId: Code Changes Lines (Repo Group) parameters: - description: Repository Group ID in: path @@ -1704,12 +1743,15 @@ paths: schema: items: properties: - commit_count: - description: 'Example: 173' + added: + description: 'Example: 1135' type: integer date: description: 'Example: 2018-01-01T00:00:00.000Z' type: string + removed: + description: 'Example: 101' + type: integer repo_id: description: 'Example: 21337' type: integer @@ -1719,20 +1761,26 @@ paths: type: array tags: - evolution - /repo-groups/:repo_group_id/code-changes-lines: + /repos/:repo_id/code-changes-lines: get: description: 'Time series of lines added and removed during a certain period. ' externalDocs: description: CHAOSS Metric Definition url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes_Lines.md - operationId: Code Changes Lines (Repo Group) + operationId: Code Changes Lines (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string - description: Periodicity specification. in: path name: period @@ -1758,19 +1806,16 @@ paths: items: properties: added: - description: 'Example: 1135' + description: 'Example: 17613' type: integer date: - description: 'Example: 2018-01-01T00:00:00.000Z' + description: 'Example: 2015-06-01T00:00:00.000Z' type: string removed: - description: 'Example: 101' - type: integer - repo_id: - description: 'Example: 21337' + description: 'Example: 106' type: integer repo_name: - description: 'Example: graphql-wg' + description: 'Example: graphql-js' type: string type: array tags: @@ -1840,6 +1885,71 @@ paths: type: array tags: - evolution + /repos/:repo_id/contributors: + get: + description: 'List of contributors and their contributions. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors.md + operationId: Contributors (Repo) + parameters: + - description: Repository Group ID. + in: path + name: repo_group_id + schema: + type: string + type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date + schema: + type: string + type: string + responses: + '200': + description: OK + schema: + items: + properties: + commit_comments: + description: 'Example: 0' + type: integer + commits: + description: 'Example: 0' + type: integer + issue_comments: + description: 'Example: 0' + type: integer + issues: + description: 'Example: 2' + type: integer + pull_request_comments: + description: 'Example: 0' + type: integer + pull_requests: + description: 'Example: 0' + type: integer + total: + description: 'Example: 2' + type: integer + user: + description: 'Example: 1' + type: integer + type: array + tags: + - evolution /repo-groups/:repo_group_id/contributors-new: get: description: 'Time series of number of new contributors during a certain period. ' @@ -1893,6 +2003,65 @@ paths: type: array tags: - evolution + /repos/:repo_id/contributors-new: + get: + description: 'Time series of number of new contributors during a certain period. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md + operationId: New Contributors (Repo) + parameters: + - description: Repository Group ID. + in: path + name: repo_group_id + schema: + type: string + type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date + schema: + type: string + type: string + responses: + '200': + description: OK + schema: + items: + properties: + date: + description: 'Example: 2018-05-20T00:00:00.000Z' + type: string + new_contributors: + description: 'Example: 3' + type: integer + repo_id: + description: 'Example: 21000' + type: integer + repo_name: + description: 'Example: rails' + type: string + type: array + tags: + - evolution /repo-groups/:repo_group_id/issue-backlog: get: description: 'Number of issues currently open. ' @@ -1925,20 +2094,26 @@ paths: type: array tags: - evolution - /repo-groups/:repo_group_id/issue-duration: + /repos/:repo_id/issue-backlog: get: description: 'Time since an issue is proposed until it is closed. ' externalDocs: description: CHAOSS Metric Definition url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Duration (Repo Group) + operationId: Issue Duration (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -1958,22 +2133,19 @@ paths: items: properties: closed_at: - description: 'Example: 2011-05-06T20:21:47.000Z' + description: 'Example: 2011-04-14T23:27:33.000Z' type: string created_at: - description: 'Example: 2011-05-06T20:20:05.000Z' + description: 'Example: 2011-02-13T03:46:06.000Z' type: string duration: - description: 'Example: 0 days 00:01:42.000000000' + description: 'Example: 60 days 19:41:27.000000000' type: string issue_id: - description: 'Example: 50320' - type: integer - repo_id: - description: 'Example: 21017' + description: 'Example: 50306' type: integer repo_name: - description: 'Example: ssl_requirement' + description: 'Example: exception_notification' type: string type: array tags: @@ -2028,56 +2200,23 @@ paths: type: array tags: - evolution - /repo-groups/:repo_group_id/issue-throughput: + /repos/:repo_id/issue-participants: get: - description: 'Ratio of issues closed to total issues. ' + description: 'How many persons participated in the discussion of issues. ' externalDocs: description: CHAOSS Metric Definition url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Throughput (Repo Group) - parameters: - - description: Repository Group ID - in: path - name: repo_group_id - schema: - type: string - type: string - responses: - '200': - description: OK - schema: - items: - properties: - repo_id: - description: 'Example: 21681' - type: integer - repo_name: - description: 'Example: incubator-zipkin' - type: string - throughput: - description: 'Example: 0.819125' - type: string - type: array - tags: - - evolution - /repo-groups/:repo_group_id/issues-active: - get: - description: 'Time series of number of issues that showed some activity during - a certain period. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Active.md - operationId: Issues Active (Repo Group) + operationId: Issue Participants (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string - - description: Periodicity specification. + - description: Repository ID. in: path - name: period + name: repo_id schema: type: string type: string @@ -2099,28 +2238,28 @@ paths: schema: items: properties: - date: - description: 'Example: 2019-01-01T00:00:00.000Z' + created_at: + description: 'Example: 2017-03-02T21:14:46.000Z' type: string - issues: - description: 'Example: 18' + issue_id: + description: 'Example: 50796' type: integer - repo_id: - description: 'Example: 21039' + participants: + description: 'Example: 1' type: integer repo_name: - description: 'Example: rails_xss' + description: 'Example: arel' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/issues-closed: + /repo-groups/:repo_group_id/issue-throughput: get: - description: 'Time series of number of issues closed during a certain period. ' + description: 'Ratio of issues closed to total issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Closed.md - operationId: Issues Closed (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Throughput (Repo Group) parameters: - description: Repository Group ID in: path @@ -2128,93 +2267,67 @@ paths: schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - date: - description: 'Example: 2019-01-01T00:00:00.000Z' - type: string - issues: - description: 'Example: 425' - type: integer repo_id: description: 'Example: 21681' type: integer repo_name: description: 'Example: incubator-zipkin' type: string + throughput: + description: 'Example: 0.819125' + type: string type: array tags: - evolution - /repo-groups/:repo_group_id/issues-closed-resolution-duration: + /repos/:repo_id/issue-throughput: get: - description: 'Duration of time for issues to be resolved. ' + description: 'Ratio of issues closed to total issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-closed-resolution-duration.md - operationId: Closed Issue Resolution Duration (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Throughput (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: - closed_at: - description: 'Example: 2019-05-22T05:27:29.000Z' - type: string - created_at: - description: 'Example: 2019-05-22T03:18:13.000Z' - type: string - diffdate: - description: 'Example: 0.0' - type: string - gh_issue_number: - description: 'Example: 4110' - type: integer - issue_title: - description: 'Example: rm incubating word' - type: string repo_name: - description: 'Example: incubator-dubbo' + description: 'Example: rails-contributors' + type: string + throughput: + description: 'Example: 0.997531' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/issues-first-time-closed: + /repo-groups/:repo_group_id/issues-active: get: - description: 'Number of persons closing an issue for the first time. ' + description: 'Time series of number of issues that showed some activity during + a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-closed.md - operationId: Closed Issues New Contributor (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Active.md + operationId: Issues Active (Repo Group) parameters: - description: Repository Group ID in: path @@ -2246,35 +2359,42 @@ paths: schema: items: properties: - count: - description: 'Example: 3' - type: integer - issue_date: - description: 'Example: 2018-05-20T00:00:00.000Z' + date: + description: 'Example: 2019-01-01T00:00:00.000Z' type: string + issues: + description: 'Example: 18' + type: integer repo_id: - description: 'Example: 21000' + description: 'Example: 21039' type: integer repo_name: - description: 'Example: rails' + description: 'Example: rails_xss' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/issues-first-time-opened: + /repos/:repo_id/issues-active: get: - description: 'Number of persons opening an issue for the first time. ' + description: 'Time series of number of issues that showed some activity during + a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-opened.md - operationId: New Contributors of Issues (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Active.md + operationId: Issues Active (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string - description: Periodicity specification. in: path name: period @@ -2299,14 +2419,11 @@ paths: schema: items: properties: - count: - description: 'Example: 3' - type: integer - issue_date: - description: 'Example: 2018-05-20T00:00:00.000Z' + date: + description: 'Example: 2011-01-01T00:00:00.000Z' type: string - repo_id: - description: 'Example: 21000' + issues: + description: 'Example: 30' type: integer repo_name: description: 'Example: rails' @@ -2314,13 +2431,13 @@ paths: type: array tags: - evolution - /repo-groups/:repo_group_id/issues-maintainer-response-duration: + /repo-groups/:repo_group_id/issues-closed: get: - description: 'Duration of time for issues to be resolved. ' + description: 'Time series of number of issues closed during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-maintainer-response-duration.md - operationId: Issue Response Time (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Closed.md + operationId: Issues Closed (Repo Group) parameters: - description: Repository Group ID in: path @@ -2328,6 +2445,12 @@ paths: schema: type: string type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -2346,32 +2469,41 @@ paths: schema: items: properties: - average_days_comment: - description: 'Example: 27.1111111111' + date: + description: 'Example: 2019-01-01T00:00:00.000Z' type: string + issues: + description: 'Example: 425' + type: integer repo_id: - description: 'Example: 21987' + description: 'Example: 21681' type: integer repo_name: - description: 'Example: qpid-proton' + description: 'Example: incubator-zipkin' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/issues-new: + /repos/:repo_id/issues-closed: get: - description: 'Time series of number of new issues opened during a certain period. ' + description: 'Time series of number of issues closed during a certain period. ' externalDocs: description: CHAOSS Metric Definition url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md - operationId: Issues New (Repo Group) + operationId: Issues Closed (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string - description: Periodicity specification. in: path name: period @@ -2397,27 +2529,24 @@ paths: items: properties: date: - description: 'Example: 2019-01-01T00:00:00.000Z' + description: 'Example: 2012-01-01T00:00:00.000Z' type: string issues: - description: 'Example: 318' - type: integer - repo_id: - description: 'Example: 21000' + description: 'Example: 97' type: integer repo_name: - description: 'Example: rails' + description: 'Example: incubator-pagespeed-ngx' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/issues-open-age: + /repo-groups/:repo_group_id/issues-closed-resolution-duration: get: - description: 'Age of open issues. ' + description: 'Duration of time for issues to be resolved. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-open-age.md - operationId: Open Issue Age (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-closed-resolution-duration.md + operationId: Closed Issue Resolution Duration (Repo Group) parameters: - description: Repository Group ID in: path @@ -2431,54 +2560,44 @@ paths: schema: items: properties: - date: - description: 'Example: 2009-05-15T19:48:43.000Z' + closed_at: + description: 'Example: 2019-05-22T05:27:29.000Z' type: string - issue_id: - description: 'Example: 38318' - type: integer - open_date: - description: 'Example: 3696' - type: integer - repo_id: - description: 'Example: 21000' + created_at: + description: 'Example: 2019-05-22T03:18:13.000Z' + type: string + diffdate: + description: 'Example: 0.0' + type: string + gh_issue_number: + description: 'Example: 4110' type: integer + issue_title: + description: 'Example: rm incubating word' + type: string repo_name: - description: 'Example: rails' + description: 'Example: incubator-dubbo' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/pull-requests-merge-contributor-new: + /repos/:repo_id/issues-closed-resolution-duration: get: - description: 'Number of persons contributing with an accepted commit for the - first time. ' + description: 'Duration of time for issues to be resolved. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/pull-requests-merge-contributor-new.md - operationId: New Contributors of Commits (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-closed-resolution-duration.md + operationId: Closed Issue Resolution Duration (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + - description: Repository ID. in: path - name: end_date + name: repo_id schema: type: string type: string @@ -2488,28 +2607,37 @@ paths: schema: items: properties: - commit_count: - description: 'Example: 711' + closed_at: + description: 'Example: 2019-06-17T03:12:48.000Z' + type: string + created_at: + description: 'Example: 2019-05-31T07:55:44.000Z' + type: string + diffdate: + description: 'Example: 16.0' + type: string + gh_issue_number: + description: 'Example: 4223' type: integer - commit_date: - description: 'Example: 2018-01-01T00:00:00.000Z' + issue_title: + description: 'Example: Cloud Native PR' type: string - count: - description: 'Example: 5140' + repo_id: + description: 'Example: 21682' type: integer repo_name: - description: 'Example: rails' + description: 'Example: incubator-dubbo' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/review-duration: + /repo-groups/:repo_group_id/issues-first-time-closed: get: - description: 'Time since an review/pull request is proposed until it is accepted. ' + description: 'Number of persons closing an issue for the first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md - operationId: Review Duration (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-closed.md + operationId: Closed Issues New Contributor (Repo Group) parameters: - description: Repository Group ID in: path @@ -2517,6 +2645,12 @@ paths: schema: type: string type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -2535,42 +2669,41 @@ paths: schema: items: properties: - created_at: - description: 'Example: 2010-09-28T19:07:15.000Z' - type: string - duration: - description: 'Example: 0 days 22:39:44.000000000' - type: string - merged_at: - description: 'Example: 2010-09-29T17:46:59.000Z' - type: string - pull_request_id: - description: 'Example: 25386' + count: + description: 'Example: 3' type: integer + issue_date: + description: 'Example: 2018-05-20T00:00:00.000Z' + type: string repo_id: - description: 'Example: 21035' + description: 'Example: 21000' type: integer repo_name: - description: 'Example: prototype-ujs' + description: 'Example: rails' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/reviews: + /repos/:repo_id/issues-first-time-closed: get: - description: 'Time series of number of new reviews / pull requests opened within - a certain period. ' + description: 'Number of persons closing an issue for the first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/reviews.md - operationId: Reviews (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-closed.md + operationId: Closed Issues New Contributors (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string - description: Periodicity specification. in: path name: period @@ -2595,29 +2728,25 @@ paths: schema: items: properties: - date: - description: 'Example: 2010-01-01T00:00:00.000Z' - type: string - pull_requests: - description: 'Example: 1' - type: integer - repo_id: - description: 'Example: 21035' + count: + description: 'Example: 3' type: integer + issue_date: + description: 'Example: 2018-05-20T00:00:00.000Z' + type: string repo_name: - description: 'Example: prototype-ujs' + description: 'Example: rails' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/reviews-accepted: + /repo-groups/:repo_group_id/issues-first-time-opened: get: - description: 'Time series of number of accepted reviews / pull requests opened - within a certain period. ' + description: 'Number of persons opening an issue for the first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md - operationId: Reviews Accepted (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-opened.md + operationId: New Contributors of Issues (Repo Group) parameters: - description: Repository Group ID in: path @@ -2649,36 +2778,41 @@ paths: schema: items: properties: - date: - description: 'Example: 2010-01-01T00:00:00.000Z' - type: string - pull_requests: - description: 'Example: 1' + count: + description: 'Example: 3' type: integer + issue_date: + description: 'Example: 2018-05-20T00:00:00.000Z' + type: string repo_id: - description: 'Example: 21035' + description: 'Example: 21000' type: integer repo_name: - description: 'Example: prototype-ujs' + description: 'Example: rails' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/reviews-declined: + /repos/:repo_id/issues-first-time-opened: get: - description: 'Time series of number of declined reviews / pull requests opened - within a certain period. ' + description: 'Number of persons opening an issue for the first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md - operationId: Reviews Declined (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-opened.md + operationId: New Contributors of Issues (Repo) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string - description: Periodicity specification. in: path name: period @@ -2703,28 +2837,25 @@ paths: schema: items: properties: - date: - description: 'Example: 2010-01-01T00:00:00.000Z' - type: string - pull_requests: - description: 'Example: 1' - type: integer - repo_id: - description: 'Example: 21035' + count: + description: 'Example: 3' type: integer + issue_date: + description: 'Example: 2018-05-20T00:00:00.000Z' + type: string repo_name: - description: 'Example: prototype-ujs' + description: 'Example: rails' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/sub-projects: + /repo-groups/:repo_group_id/issues-maintainer-response-duration: get: - description: 'Number of sub-projects. ' + description: 'Duration of time for issues to be resolved. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/sub-projects.md - operationId: Sub-Projects (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-maintainer-response-duration.md + operationId: Issue Response Time (Repo Group) parameters: - description: Repository Group ID in: path @@ -2750,53 +2881,27 @@ paths: schema: items: properties: - sub_protject_count: - description: 'Example: 2' - type: integer - type: array - tags: - - evolution - /repos/:repo_id/closed-issues-count: - get: - description: 'Count of closed issues. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md - operationId: Closed Issues Count (Repo Group) - parameters: - - description: Repository Group ID - in: path - name: repo_group_id - schema: - type: string - type: string - responses: - '200': - description: OK - schema: - items: - properties: - closed_count: - description: 'Example: 4' - type: integer - date: - description: 'Example: 2014-06-02T00:00:00.000Z' + average_days_comment: + description: 'Example: 27.1111111111' type: string - rg_name: - description: 'Example: Apache' + repo_id: + description: 'Example: 21987' + type: integer + repo_name: + description: 'Example: qpid-proton' type: string type: array tags: - evolution - /repos/:repo_id/code-changes: + /repos/:repo_id/issues-maintainer-response-duration: get: - description: 'Time series number of commits during a certain period. ' + description: 'Duration of time for issues to be resolved. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes.md - operationId: Code Changes (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-maintainer-response-duration.md + operationId: Issue Response Time (Repo) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: @@ -2808,12 +2913,6 @@ paths: schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -2832,38 +2931,32 @@ paths: schema: items: properties: - commit_count: - description: 'Example: 90' - type: integer - date: - description: 'Example: 2015-01-01T00:00:00.000Z' + average_days_comment: + description: 'Example: 27.1111111111' type: string + repo_id: + description: 'Example: 21987' + type: integer repo_name: - description: 'Example: graphql' + description: 'Example: qpid-proton' type: string type: array tags: - evolution - /repos/:repo_id/code-changes-lines: + /repo-groups/:repo_group_id/issues-new: get: - description: 'Time series of lines added and removed during a certain period. ' + description: 'Time series of number of new issues opened during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes_Lines.md - operationId: Code Changes Lines (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md + operationId: Issues New (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - description: Periodicity specification. in: path name: period @@ -2888,28 +2981,28 @@ paths: schema: items: properties: - added: - description: 'Example: 17613' - type: integer date: - description: 'Example: 2015-06-01T00:00:00.000Z' + description: 'Example: 2019-01-01T00:00:00.000Z' type: string - removed: - description: 'Example: 106' + issues: + description: 'Example: 318' + type: integer + repo_id: + description: 'Example: 21000' type: integer repo_name: - description: 'Example: graphql-js' + description: 'Example: rails' type: string type: array tags: - evolution - /repos/:repo_id/contributors: + /repos/:repo_id/issues-new: get: - description: 'List of contributors and their contributions. ' + description: 'Time series of number of new issues opened during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors.md - operationId: Contributors (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md + operationId: Issues New (Repo) parameters: - description: Repository Group ID. in: path @@ -2923,6 +3016,12 @@ paths: schema: type: string type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -2941,71 +3040,32 @@ paths: schema: items: properties: - commit_comments: - description: 'Example: 0' - type: integer - commits: - description: 'Example: 0' - type: integer - issue_comments: - description: 'Example: 0' - type: integer + date: + description: 'Example: 2015-01-01T00:00:00.000Z' + type: string issues: - description: 'Example: 2' - type: integer - pull_request_comments: - description: 'Example: 0' - type: integer - pull_requests: - description: 'Example: 0' - type: integer - total: - description: 'Example: 2' - type: integer - user: - description: 'Example: 1' + description: 'Example: 116' type: integer + repo_name: + description: 'Example: rails' + type: string type: array tags: - evolution - /repos/:repo_id/contributors-new: + /repo-groups/:repo_group_id/issues-open-age: get: - description: 'Time series of number of new contributors during a certain period. ' + description: 'Age of open issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md - operationId: New Contributors (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-open-age.md + operationId: Open Issue Age (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK @@ -3013,10 +3073,13 @@ paths: items: properties: date: - description: 'Example: 2018-05-20T00:00:00.000Z' + description: 'Example: 2009-05-15T19:48:43.000Z' type: string - new_contributors: - description: 'Example: 3' + issue_id: + description: 'Example: 38318' + type: integer + open_date: + description: 'Example: 3696' type: integer repo_id: description: 'Example: 21000' @@ -3027,13 +3090,13 @@ paths: type: array tags: - evolution - /repos/:repo_id/issue-backlog: + /repos/:repo_id/issues-open-age: get: - description: 'Time since an issue is proposed until it is closed. ' + description: 'Age of open issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Duration (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-open-age.md + operationId: Open Issue Age (Repo) parameters: - description: Repository Group ID. in: path @@ -3047,59 +3110,48 @@ paths: schema: type: string type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - closed_at: - description: 'Example: 2011-04-14T23:27:33.000Z' - type: string - created_at: - description: 'Example: 2011-02-13T03:46:06.000Z' - type: string - duration: - description: 'Example: 60 days 19:41:27.000000000' + date: + description: 'Example: 2009-05-15T19:48:43.000Z' type: string issue_id: - description: 'Example: 50306' + description: 'Example: 38318' + type: integer + open_date: + description: 'Example: 3696' + type: integer + repo_id: + description: 'Example: 21000' type: integer repo_name: - description: 'Example: exception_notification' + description: 'Example: rails' type: string type: array tags: - evolution - /repos/:repo_id/issue-participants: + /repo-groups/:repo_group_id/pull-requests-merge-contributor-new: get: - description: 'How many persons participated in the discussion of issues. ' + description: 'Number of persons contributing with an accepted commit for the + first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Participants (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/pull-requests-merge-contributor-new.md + operationId: New Contributors of Commits (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period schema: type: string type: string @@ -3121,28 +3173,29 @@ paths: schema: items: properties: - created_at: - description: 'Example: 2017-03-02T21:14:46.000Z' - type: string - issue_id: - description: 'Example: 50796' + commit_count: + description: 'Example: 711' type: integer - participants: - description: 'Example: 1' + commit_date: + description: 'Example: 2018-01-01T00:00:00.000Z' + type: string + count: + description: 'Example: 5140' type: integer repo_name: - description: 'Example: arel' + description: 'Example: rails' type: string type: array tags: - evolution - /repos/:repo_id/issue-throughput: + /repos/:repo_id/pull-requests-merge-contributor-new: get: - description: 'Ratio of issues closed to total issues. ' + description: 'Number of persons contributing with an accepted commit for the + first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Throughput (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/pull-requests-merge-contributor-new.md + operationId: New Contributors of Commits (Repo) parameters: - description: Repository Group ID. in: path @@ -3156,48 +3209,56 @@ paths: schema: type: string type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: - repo_name: - description: 'Example: rails-contributors' + commit_date: + description: 'Example: 2018-01-01T00:00:00.000Z' type: string - throughput: - description: 'Example: 0.997531' + count: + description: 'Example: 2287' + type: integer + repo_name: + description: 'Example: rails' type: string type: array tags: - evolution - /repos/:repo_id/issues-active: + /repo-groups/:repo_group_id/review-duration: get: - description: 'Time series of number of issues that showed some activity during - a certain period. ' + description: 'Time since an review/pull request is proposed until it is accepted. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Active.md - operationId: Issues Active (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md + operationId: Review Duration (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -3216,25 +3277,34 @@ paths: schema: items: properties: - date: - description: 'Example: 2011-01-01T00:00:00.000Z' + created_at: + description: 'Example: 2010-09-28T19:07:15.000Z' type: string - issues: - description: 'Example: 30' + duration: + description: 'Example: 0 days 22:39:44.000000000' + type: string + merged_at: + description: 'Example: 2010-09-29T17:46:59.000Z' + type: string + pull_request_id: + description: 'Example: 25386' + type: integer + repo_id: + description: 'Example: 21035' type: integer repo_name: - description: 'Example: rails' + description: 'Example: prototype-ujs' type: string type: array tags: - evolution - /repos/:repo_id/issues-closed: + /repos/:repo_id/review-duration: get: - description: 'Time series of number of issues closed during a certain period. ' + description: 'Time since an review/pull request is proposed until it is accepted. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md - operationId: Issues Closed (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md + operationId: Review Duration (Repo) parameters: - description: Repository Group ID. in: path @@ -3248,12 +3318,6 @@ paths: schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -3272,88 +3336,39 @@ paths: schema: items: properties: - date: - description: 'Example: 2012-01-01T00:00:00.000Z' - type: string - issues: - description: 'Example: 97' - type: integer - repo_name: - description: 'Example: incubator-pagespeed-ngx' - type: string - type: array - tags: - - evolution - /repos/:repo_id/issues-closed-resolution-duration: - get: - description: 'Duration of time for issues to be resolved. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-closed-resolution-duration.md - operationId: Closed Issue Resolution Duration (Repo) - parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - responses: - '200': - description: OK - schema: - items: - properties: - closed_at: - description: 'Example: 2019-06-17T03:12:48.000Z' - type: string created_at: - description: 'Example: 2019-05-31T07:55:44.000Z' + description: 'Example: 2019-01-02T11:02:08.000Z' type: string - diffdate: - description: 'Example: 16.0' + duration: + description: 'Example: 183 days 22:08:37.000000000' type: string - gh_issue_number: - description: 'Example: 4223' - type: integer - issue_title: - description: 'Example: Cloud Native PR' + merged_at: + description: 'Example: 2019-07-05T09:10:45.000Z' type: string - repo_id: - description: 'Example: 21682' + pull_request_id: + description: 'Example: 25374' type: integer repo_name: - description: 'Example: incubator-dubbo' + description: 'Example: graphql-spec' type: string type: array tags: - evolution - /repos/:repo_id/issues-first-time-closed: + /repo-groups/:repo_group_id/reviews: get: - description: 'Number of persons closing an issue for the first time. ' + description: 'Time series of number of new reviews / pull requests opened within + a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-closed.md - operationId: Closed Issues New Contributors (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/reviews.md + operationId: Reviews (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - description: Periodicity specification. in: path name: period @@ -3378,25 +3393,29 @@ paths: schema: items: properties: - count: - description: 'Example: 3' - type: integer - issue_date: - description: 'Example: 2018-05-20T00:00:00.000Z' + date: + description: 'Example: 2010-01-01T00:00:00.000Z' type: string + pull_requests: + description: 'Example: 1' + type: integer + repo_id: + description: 'Example: 21035' + type: integer repo_name: - description: 'Example: rails' + description: 'Example: prototype-ujs' type: string type: array tags: - evolution - /repos/:repo_id/issues-first-time-opened: + /repos/:repo_id/reviews: get: - description: 'Number of persons opening an issue for the first time. ' + description: 'Time series of number of new reviews / pull requests opened within + a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-opened.md - operationId: New Contributors of Issues (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/reviews.md + operationId: Reviews (Repo) parameters: - description: Repository Group ID. in: path @@ -3434,25 +3453,26 @@ paths: schema: items: properties: - count: - description: 'Example: 3' - type: integer - issue_date: - description: 'Example: 2018-05-20T00:00:00.000Z' + date: + description: 'Example: 2016-01-01T00:00:00.000Z' type: string + pull_requests: + description: 'Example: 37' + type: integer repo_name: - description: 'Example: rails' + description: 'Example: graphql-spec' type: string type: array tags: - evolution - /repos/:repo_id/issues-maintainer-response-duration: + /repo-groups/:repo_group_id/reviews-accepted: get: - description: 'Duration of time for issues to be resolved. ' + description: 'Time series of number of accepted reviews / pull requests opened + within a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-maintainer-response-duration.md - operationId: Issue Response Time (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md + operationId: Reviews Accepted (Repo Group) parameters: - description: Repository Group ID in: path @@ -3460,9 +3480,9 @@ paths: schema: type: string type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period schema: type: string type: string @@ -3484,25 +3504,29 @@ paths: schema: items: properties: - average_days_comment: - description: 'Example: 27.1111111111' + date: + description: 'Example: 2010-01-01T00:00:00.000Z' type: string + pull_requests: + description: 'Example: 1' + type: integer repo_id: - description: 'Example: 21987' + description: 'Example: 21035' type: integer repo_name: - description: 'Example: qpid-proton' + description: 'Example: prototype-ujs' type: string type: array tags: - evolution - /repos/:repo_id/issues-new: + /repos/:repo_id/reviews-accepted: get: - description: 'Time series of number of new issues opened during a certain period. ' + description: 'Time series of number of accepted reviews / pull requests opened + within a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md - operationId: Issues New (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md + operationId: Reviews Accepted (Repo) parameters: - description: Repository Group ID. in: path @@ -3541,34 +3565,47 @@ paths: items: properties: date: - description: 'Example: 2015-01-01T00:00:00.000Z' + description: 'Example: 2016-01-01T00:00:00.000Z' type: string - issues: - description: 'Example: 116' + pull_requests: + description: 'Example: 30' type: integer repo_name: - description: 'Example: rails' + description: 'Example: graphql-spec' type: string type: array tags: - evolution - /repos/:repo_id/issues-open-age: + /repo-groups/:repo_group_id/reviews-declined: get: - description: 'Age of open issues. ' + description: 'Time series of number of declined reviews / pull requests opened + within a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-open-age.md - operationId: Open Issue Age (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md + operationId: Reviews Declined (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date schema: type: string type: string @@ -3579,31 +3616,28 @@ paths: items: properties: date: - description: 'Example: 2009-05-15T19:48:43.000Z' + description: 'Example: 2010-01-01T00:00:00.000Z' type: string - issue_id: - description: 'Example: 38318' - type: integer - open_date: - description: 'Example: 3696' + pull_requests: + description: 'Example: 1' type: integer repo_id: - description: 'Example: 21000' + description: 'Example: 21035' type: integer repo_name: - description: 'Example: rails' + description: 'Example: prototype-ujs' type: string type: array tags: - evolution - /repos/:repo_id/pull-requests-merge-contributor-new: + /repos/:repo_id/reviews-declined: get: - description: 'Number of persons contributing with an accepted commit for the - first time. ' + description: 'Time series of number of declined reviews / pull requests opened + within a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/pull-requests-merge-contributor-new.md - operationId: New Contributors of Commits (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md + operationId: Reviews Declined (Repo) parameters: - description: Repository Group ID. in: path @@ -3641,35 +3675,41 @@ paths: schema: items: properties: - commit_date: - description: 'Example: 2018-01-01T00:00:00.000Z' + date: + description: 'Example: 2016-01-01T00:00:00.000Z' type: string - count: - description: 'Example: 2287' + pull_requests: + description: 'Example: 11' type: integer repo_name: - description: 'Example: rails' + description: 'Example: graphql-spec' type: string type: array tags: - evolution - /repos/:repo_id/releases: + /repo-groups/:repo_group_id/sub-projects: get: - description: 'Time since an review/pull request is proposed until it is accepted. ' + description: 'Number of sub-projects. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md - operationId: Number of releases (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/sub-projects.md + operationId: Sub-Projects (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_id + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date schema: type: string type: string @@ -3679,28 +3719,19 @@ paths: schema: items: properties: - latest: - description: 'Example: 2019-11-02T11:02:08.000Z' - type: string - total_count: - description: 'Example: 35' - type: integer - latest_patch_release: - description: 'Example: 2019-01-02T15:20:07.000Z' - type: string - total_patch_count: - description: 'Example: 21' + sub_protject_count: + description: 'Example: 2' type: integer type: array tags: - evolution - /repos/:repo_id/review-duration: + /repos/:repo_id/sub-projects: get: - description: 'Time since an review/pull request is proposed until it is accepted. ' + description: 'Number of sub-projects. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md - operationId: Review Duration (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/sub-projects.md + operationId: Sub-Projects (Repo) parameters: - description: Repository Group ID. in: path @@ -3732,34 +3763,21 @@ paths: schema: items: properties: - created_at: - description: 'Example: 2019-01-02T11:02:08.000Z' - type: string - duration: - description: 'Example: 183 days 22:08:37.000000000' - type: string - merged_at: - description: 'Example: 2019-07-05T09:10:45.000Z' - type: string - pull_request_id: - description: 'Example: 25374' + sub_protject_count: + description: 'Example: 2' type: integer - repo_name: - description: 'Example: graphql-spec' - type: string type: array tags: - evolution - /repos/:repo_id/reviews: + /repo-groups/:repo_group_id/closed-issues-count: get: - description: 'Time series of number of new reviews / pull requests opened within - a certain period. ' + description: 'Count of closed issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/reviews.md - operationId: Reviews (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md + operationId: Closed Issues Count (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: @@ -3771,126 +3789,70 @@ paths: schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: + closed_count: + description: 'Example: 26' + type: integer date: - description: 'Example: 2016-01-01T00:00:00.000Z' + description: 'Example: 2018-11-26T00:00:00.000Z' type: string - pull_requests: - description: 'Example: 37' + repo_id: + description: 'Example: 21681' type: integer - repo_name: - description: 'Example: graphql-spec' - type: string type: array tags: - evolution - /repos/:repo_id/reviews-accepted: + /repos/:repo_id/closed-issues-count: get: - description: 'Time series of number of accepted reviews / pull requests opened - within a certain period. ' + description: 'Count of closed issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md - operationId: Reviews Accepted (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md + operationId: Closed Issues Count (Repo) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: + closed_count: + description: 'Example: 4' + type: integer date: - description: 'Example: 2016-01-01T00:00:00.000Z' + description: 'Example: 2014-06-02T00:00:00.000Z' type: string - pull_requests: - description: 'Example: 30' - type: integer - repo_name: - description: 'Example: graphql-spec' + rg_name: + description: 'Example: Apache' type: string type: array tags: - evolution - /repos/:repo_id/reviews-declined: + /repo-groups/:repo_group_id/issue-duration: get: - description: 'Time series of number of declined reviews / pull requests opened - within a certain period. ' + description: 'Time since an issue is proposed until it is closed. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md - operationId: Reviews Declined (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Duration (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -3909,25 +3871,34 @@ paths: schema: items: properties: - date: - description: 'Example: 2016-01-01T00:00:00.000Z' + closed_at: + description: 'Example: 2011-05-06T20:21:47.000Z' type: string - pull_requests: - description: 'Example: 11' + created_at: + description: 'Example: 2011-05-06T20:20:05.000Z' + type: string + duration: + description: 'Example: 0 days 00:01:42.000000000' + type: string + issue_id: + description: 'Example: 50320' + type: integer + repo_id: + description: 'Example: 21017' type: integer repo_name: - description: 'Example: graphql-spec' + description: 'Example: ssl_requirement' type: string type: array tags: - evolution - /repos/:repo_id/sub-projects: + /repos/:repo_id/releases: get: - description: 'Number of sub-projects. ' + description: 'Time since an review/pull request is proposed until it is accepted. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/sub-projects.md - operationId: Sub-Projects (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md + operationId: Number of releases (Repo) parameters: - description: Repository Group ID. in: path @@ -3941,15 +3912,38 @@ paths: schema: type: string type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + responses: + '200': + description: OK + schema: + items: + properties: + latest: + description: 'Example: 2019-11-02T11:02:08.000Z' + type: string + total_count: + description: 'Example: 35' + type: integer + latest_patch_release: + description: 'Example: 2019-01-02T15:20:07.000Z' + type: string + total_patch_count: + description: 'Example: 21' + type: integer + type: array + tags: + - evolution + /repo-groups/:repo_group_id/open-issues-count: + get: + description: 'Count of open issues. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md + operationId: Open Issues Count (Repo Group) + parameters: + - description: Repository Group ID in: path - name: end_date + name: repo_group_id schema: type: string type: string @@ -3959,9 +3953,15 @@ paths: schema: items: properties: - sub_protject_count: - description: 'Example: 2' + date: + description: 'Example: 2017-09-11T00:00:00.000Z' + type: string + open_count: + description: 'Example: 1' type: integer + rg_name: + description: 'Example: Netflix' + type: string type: array tags: - evolution