Skip to content

Commit 4fd688c

Browse files
Improve wording
Co-authored-by: Matti Schneider <matti@opentermsarchive.org>
1 parent 553b542 commit 4fd688c

1 file changed

Lines changed: 10 additions & 11 deletions

File tree

content/analysis/reference/copywriting.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ aliases: /memos/copywriting-reference/
55

66
# Memo copywriting
77

8-
Memos are short analysis of detected changes, whose is *[diff](https://en.wikipedia.org/wiki/Diff)* the atomic unit.
8+
Memos are short analyses of detected changes, whose _[diff](https://en.wikipedia.org/wiki/Diff)_ is the atomic unit.
99

1010
- They must first describe what has been added and what has been deleted.
1111
- Their secondary objective is to provide materials to demonstrate matters of interest and further investigations.
@@ -23,9 +23,9 @@ A memo must contain:
2323
It may also contain:
2424

2525
- [a topic](#topic-optional);
26-
- [a contextualisation](#contextualisation-optional).
26+
- [a context](#contextualisation-optional).
2727

28-
Each element is explained in detail below.
28+
Each of these components is explained in detail below.
2929

3030
## Title
3131

@@ -95,9 +95,8 @@ Each element is explained in detail below.
9595
- If you write in a different language than the detected change, always look for citations in the version of the document that matches the language of writing if it exists instead of translating them yourself.
9696
- __Use British English throughout__
9797
- “organisation” and not “organization”
98-
- No full point in abbreviations
99-
- See also
100-
- [Guardian style guide](https://www.theguardian.com/guardian-style-guide-a)
98+
- Don't use full stops in abbreviations (e.g. write “EU” and “USA” instead of “E.U.” and “U.S.A.”).
99+
- For more details, follow the [Guardian style guide](https://www.theguardian.com/guardian-style-guide-a).
101100
- *New Hart’s Rules. The Oxford Style Guide*, 2014
102101

103102
**Example**
@@ -106,7 +105,7 @@ Each element is explained in detail below.
106105
>
107106
> OpenAI also extended export restrictions to plugins ‘located’ in countries embargoed or sanctioned by the US. This provision previously concerned only plugin owners.
108107
109-
## Topic (optional)
108+
## Topic _(optional)_
110109

111110
- You can fill a topic by identifying it from the following list:
112111

@@ -122,16 +121,16 @@ Each element is explained in detail below.
122121
| Data Sovereignty | Data governance, cross-border data flows |
123122
| Copyright | Fair use and licensing rules, verification and reporting mechanisms, monetisation |
124123

125-
Please note that if the diff has changes related to more than one topic, write separate memos for each topic.
124+
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.
126125

127-
## Contextualisation (optional)
126+
## Context _(optional)_
128127

129-
Explain which wider problems are tackled by this policy change, or give a historical perspective on the change.
128+
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.
130129

131130
- Write the contextualisation text in a new paragraph.
132131
- Add external links to the most authoritative sources available.
133132

134-
**Example**
133+
#### Example
135134

136135
> [...]
137136
>

0 commit comments

Comments
 (0)