Skip to content

Commit b27373b

Browse files
clementbironMattiSG
andcommitted
Improve wording
Co-authored-by: Matti Schneider <matti@opentermsarchive.org>
1 parent bde191b commit b27373b

1 file changed

Lines changed: 13 additions & 15 deletions

File tree

content/analysis/reference/copywriting.md

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

1616
A memo must contain:
1717

18-
- [a title](#title);
19-
- [a service name](#service-name);
20-
- [a terms type](#terms-types);
18+
- a [title](#title);
19+
- a [service name](#service-name);
20+
- a [terms type](#terms-types);
2121
- a [change date](#date-modified);
2222
- [body text](#body-text).
2323

2424
It may also contain:
2525

26-
- [a topic](#topic-optional);
27-
- [a context](#contextualisation-optional).
26+
- [context](#contextualisation-optional);
27+
- a [topic](#topic-optional).
2828

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

@@ -104,9 +104,16 @@ Each of these components is explained in detail below.
104104
>
105105
> OpenAI also extended export restrictions to plugins ‘located’ in countries embargoed or sanctioned by the US. This provision previously concerned only plugin owners.
106106
107+
## Context _(optional)_
108+
109+
The goal of the context is to help the general public make sense of the changes, which can often be applied in reaction to a geopolitical or regulatory tension. To that end, explain which wider problems are tackled by this policy change, or give a historical perspective on the change. Depending on your production goals, you might want to focus on specific angles such as real-world harms, capital concentration, geopolitical evolutions… all are valid, and this section simply describes how to integrate these additional perspectives in a memo so that they don’t take over the change analysis itself.
110+
111+
- Write the contextualisation text in a new paragraph.
112+
- Add external links to the most authoritative sources available.
113+
107114
## Topic _(optional)_
108115

109-
- You can fill a topic by identifying it from the following list:
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 to group the changes into that should each warrant their own memo.
110117

111118
| Topic | Subtopics |
112119
|----------------------------|----------------------------------------------------------------------------------------------|
@@ -120,15 +127,6 @@ Each of these components is explained in detail below.
120127
| Data Sovereignty | Data governance, cross-border data flows |
121128
| Copyright | Fair use and licensing rules, verification and reporting mechanisms, monetisation |
122129

123-
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 to group the changes into that should each warrant their own memo.
124-
125-
## Context _(optional)_
126-
127-
The goal of the context is to help the general public make sense of the changes, which can often be applied in reaction to a geopolitical or regulatory tension. To that end, explain which wider problems are tackled by this policy change, or give a historical perspective on the change. Depending on your production goals, you might want to focus on specific angles such as real-world harms, capital concentration, geopolitical evolutions… all are valid, and this section simply describes how to integrate these additional perspectives in a memo so that they don’t take over the change analysis itself.
128-
129-
- Write the contextualisation text in a new paragraph.
130-
- Add external links to the most authoritative sources available.
131-
132130
#### Example
133131

134132
> [...]

0 commit comments

Comments
 (0)