Skip to content

Commit 4d4940e

Browse files
authored
Describe community feedback method
#83
2 parents 31b582e + 4c0175c commit 4d4940e

2 files changed

Lines changed: 17 additions & 5 deletions

File tree

CHANGELOG.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22

33
All changes that impact users of this module are documented in this file, in the [Common Changelog](https://common-changelog.org) format with some additional specifications defined in the [CONTRIBUTING](./CONTRIBUTING.md) file. This codebase adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
44

5+
## Unreleased [no-release]
6+
7+
_Modifications made in this changeset do not add, remove or alter any behavior, dependency, API or functionality of the software. They only change non-functional parts of the repository, such as the README file or CI workflows._
8+
59
## 1.3.0 - 2024-08-12
610

711
_Full changeset and discussions: [#62](https://github.com/OpenTermsArchive/terms-types/pull/62)._

CONTRIBUTING.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ First of all, thanks for taking the time to contribute! 🎉👍
33
## Table of Contents
44

55
- [Add new Terms Types](#add-new-terms-types)
6-
- [Open a discussion](#open-a-discussion)
7-
- [Integration process](#integration-process)
86
- [Governance considerations](#governance-considerations)
97
- [List a new contributor](#list-a-new-contributor)
108
- [Changelog](#changelog)
@@ -31,13 +29,23 @@ Note that service-specific types (such as “Twitter Privacy Policy”) are not
3129

3230
### Integration process
3331

32+
#### Qualification
33+
3434
New suggestions for terms types are categorized as `Submitted`. The Core Team reviews these suggestions and ensures that all the necessary information is gathered and clear and that at least 5 examples are provided, maximizing industry and jurisdiction diversity. Once that is the case, the discussion is moved to the `Qualified` category and opened up to the community.
3535

36-
Once your suggestion is `Qualified`, build consensus by publicizing it across Open Terms Archive channels and engaging with the community. Throughout the discussion, the data should be critically examined, especially taking into account international perspectives on vocabulary and the variety of definitions across jurisdictions.
36+
#### Community outreach
37+
38+
Once your suggestion is `Qualified`, publicize it across Open Terms Archive channels and engage with the community. This will enable multiple perspectives to be shared, yielding a clear and reusable proposal that maximises usage. Throughout the discussion, the data should be critically examined, especially taking into account international perspectives on vocabulary and the variety of definitions across jurisdictions.
39+
40+
Community feedback is expressed in the following ways:
41+
42+
- ⬆️ upvoting types suggestions that seem relevant for their field of work, thereby increasing their priority and visibility among other suggested types;
43+
- 🚀 reacting with a rocket emoji to a suggestion that seems acceptable as it is, thereby supporting its integration;
44+
- 💬 commenting on a suggestion to describe potential improvements or limitations, thereby evolving the suggestion.
3745

38-
Once a consensus has been reached and at least 2 weeks have passed since the discussion was opened (to ensure visibility within the community), a pull request for the addition to the database can be submitted. To facilitate tracking and participation, each pull request should contain only one type addition and must link to the corresponding discussion.
46+
#### Integration
3947

40-
The Core Team will then review the pull request.
48+
Integration is done on a [consent](https://www.holacracy.org/blog/why-consent-is-better-than-consensus/) basis, meaning that no remark is blocking the suggestion from moving forward. After at least 2 weeks have passed since the suggestion was initially opened or last changed, and once all pending remarks have been solved, a pull request for addition to the database can be submitted. To facilitate tracking and participation, each pull request should contain only one type addition and must link to the corresponding discussion. The Core Team will then review and potentially merge the pull request.
4149

4250
## Governance considerations
4351

0 commit comments

Comments
 (0)