Skip to content

Commit ece4e1d

Browse files
committed
Improve structure and wording
1 parent 834079d commit ece4e1d

1 file changed

Lines changed: 34 additions & 27 deletions

File tree

content/analysis/reference/copywriting.md

Lines changed: 34 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -13,18 +13,18 @@ Memos are short explanations of a specific change in some terms of a service.
1313

1414
## Structure
1515

16-
A memo must contain:
17-
16+
A memo consists of:
1817
- a [title](#title);
19-
- a [service name](#service-name);
20-
- a [terms type](#terms-types);
21-
- a [change date](#date-modified);
22-
- [body text](#body-text).
2318

24-
It may also contain:
19+
followed by the following metadata elements:
20+
- a [service name](#service-name);&é
21+
- a [terms type](#terms-types);
22+
- a [change date](#change-date);
23+
- an optional [topic](#topic-optional);
2524

26-
- [context](#contextualisation-optional);
27-
- a [topic](#topic-optional).
25+
and contains:
26+
- a [body text](#body-text);
27+
- an optional [context](#contextualisation-optional).
2828

2929
Each of these components is explained in detail below.
3030

@@ -67,7 +67,7 @@ Each of these components is explained in detail below.
6767
6868
> Community Guidelines, Terms of Service, Privacy Policy
6969
70-
## Date modified
70+
## Change date
7171

7272
- Use `Month Day, Year` format.
7373
- Avoid repeating months or years.
@@ -79,6 +79,29 @@ Each of these components is explained in detail below.
7979
8080
> June 6, December 5 and 16, 2023
8181
82+
## Topic _(optional)_
83+
84+
Changes can sometimes address several topics at once, making it difficult to narrow the memos down to a clear issue. In such cases, **write separate memos for each topic**. To support splitting, the taxonomy below can help identify topics that each warrant their own memo.
85+
86+
| Topic | Subtopics |
87+
|----------------------------|----------------------------------------------------------------------------------------------|
88+
| Privacy and Surveillance | Data collection, use, storage, and retention, informed consent, transparency |
89+
| Cybersecurity | Data breaches, security mechanisms, verification and authentication processes |
90+
| Censorship | Content prohibitions and restrictions, reporting mechanisms |
91+
| Access and Accessibility | Access to services, discrimination/exclusion risks |
92+
| Mis/Disinformation | Definitions of false/harmful content, content sharing, verification and reporting mechanisms |
93+
| Hate Speech | Definitions of violent content, content sharing, reporting mechanisms |
94+
| Algorithmic Accountability | Data use in AI training |
95+
| Data Sovereignty | Data governance, cross-border data flows |
96+
| Copyright | Fair use and licensing rules, verification and reporting mechanisms, monetisation |
97+
98+
**Examples**
99+
100+
> Hate Speech
101+
102+
> Algorithmic Accountability
103+
104+
82105
## Body text
83106

84107
- Describe changes in a neutral, objective, non-judgmental manner.
@@ -111,23 +134,7 @@ The goal of the context is to help the general public make sense of the changes,
111134
- Write the contextualisation text in a new paragraph.
112135
- Add external links to the most authoritative sources available.
113136

114-
## Topic _(optional)_
115-
116-
Changes can sometimes address several topics at once, making it difficult to narrow the memos down to a clear issue. In such cases, **write separate memos for each topic**. To support splitting, the taxonomy below can help identify topics that each warrant their own memo.
117-
118-
| Topic | Subtopics |
119-
|----------------------------|----------------------------------------------------------------------------------------------|
120-
| Privacy and Surveillance | Data collection, use, storage, and retention, informed consent, transparency |
121-
| Cybersecurity | Data breaches, security mechanisms, verification and authentication processes |
122-
| Censorship | Content prohibitions and restrictions, reporting mechanisms |
123-
| Access and Accessibility | Access to services, discrimination/exclusion risks |
124-
| Mis/Disinformation | Definitions of false/harmful content, content sharing, verification and reporting mechanisms |
125-
| Hate Speech | Definitions of violent content, content sharing, reporting mechanisms |
126-
| Algorithmic Accountability | Data use in AI training |
127-
| Data Sovereignty | Data governance, cross-border data flows |
128-
| Copyright | Fair use and licensing rules, verification and reporting mechanisms, monetisation |
129-
130-
#### Example
137+
**Example**
131138

132139
> [...]
133140
>

0 commit comments

Comments
 (0)