-
Notifications
You must be signed in to change notification settings - Fork 5
/
mkdocs.yml
executable file
·256 lines (241 loc) · 9.67 KB
/
mkdocs.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
# Project information
INHERIT: images.yml
site_name: Turing Commons
site_url: https://alan-turing-institute.github.io/turing-commons/
site_description: >-
An online platform to support open dialogue and reflection about the responsible design, development, and deployment of data-driven technologies.
repo_name: alan-turing-institute/turing-commons
repo_url: https://github.com/alan-turing-institute/turing-commons
# edit_uri: edit/main/docs/
# Copyright
copyright: Copyright © 2022 Alan Turing Institute
# Configuration
theme:
name: material
custom_dir: overrides
logo: assets/logo.png
favicon: assets/favicon.png
# Static files
static_templates:
- 404.html
# Default values, taken from mkdocs_theme.yml
language: en
features:
- announce.dismiss
- content.code.annotate
- content.code.copy
# - content.tabs.link
# - header.autohide
# - navigation.expand
- navigation.indexes
- navigation.footer
- navigation.instant
- navigation.sections
- navigation.path
- navigation.tabs
- navigation.tabs.sticky
- navigation.top
- navigation.tracking
- search.highlight
- search.share
- search.suggest
- toc.follow
# - toc.integrate
palette:
- scheme: default
primary: teal
accent: deep orange
toggle:
icon: material/toggle-switch
name: Switch to dark mode
- scheme: slate
primary: red
accent: red
toggle:
icon: material/toggle-switch-off-outline
name: Switch to light mode
font:
text: Roboto
code: Roboto Mono
# favicon: assets/logo.png
icon:
admonition:
bug: octicons/database-16
# Plugins
plugins:
- blog:
post_date_format: medium
post_url_date_format: YYYY/MM/dd
post_url_format: "{slug}"
post_readtime: true
- glightbox:
touchNavigation: true
loop: false
effect: zoom
width: 100%
height: auto
zoomable: true
draggable: true
- search:
separator: "[\\s\\-,:!=\\[\\]()\"/]+|\\.(?!\\d)|&[lg]t;|(?!\\b)(?=[A-Z][a-z])"
- tags
# - social (disabled when running locally due to library issues)
# Customization
# Extensions
markdown_extensions:
- markdown.extensions.abbr
- markdown.extensions.admonition
- markdown.extensions.attr_list
- markdown.extensions.def_list
- markdown.extensions.footnotes
- markdown.extensions.meta
- markdown.extensions.md_in_html
- markdown.extensions.toc:
permalink: true
- pymdownx.arithmatex:
generic: true
- pymdownx.betterem:
smart_enable: all
- pymdownx.caret
- pymdownx.details
- pymdownx.emoji:
emoji_generator: !!python/name:materialx.emoji.to_svg
emoji_index: !!python/name:materialx.emoji.twemoji
- pymdownx.highlight:
anchor_linenums: true
- pymdownx.inlinehilite
- pymdownx.keys
- pymdownx.magiclink:
repo_url_shorthand: true
user: squidfunk
repo: mkdocs-material
- pymdownx.mark
- pymdownx.smartsymbols
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.tabbed:
alternate_style: true
- pymdownx.tasklist:
custom_checkbox: true
- pymdownx.tilde
- pymdownx.snippets
extra_javascript:
- javascripts/mathjax.js
- https://polyfill.io/v3/polyfill.min.js?features=es6
- https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
- https://unpkg.com/[email protected]/dist/tablesort.min.js
- javascripts/tablesort.js
extra_css:
- stylesheets/extra.css
- stylesheets/gallery.css
# Page tree
nav:
- Home: index.md
- Welcome: welcome.md
- Skills Tracks:
- skills-tracks/index.md
- Responsible Research and Innovation in Data Science and AI:
- skills-tracks/rri/index.md
- What is Responsible Research and Innovation:
- skills-tracks/rri/rri-100-index.md
- Understanding Responsibility: skills-tracks/rri/rri-100-1.md
- Collective and Distributed Responsibility: skills-tracks/rri/rri-100-2.md
- Defining Responsible Research and Innovation: skills-tracks/rri/rri-100-3.md
- The Scope and Horizon of Responsibility: skills-tracks/rri/rri-100-4.md
- The Project Lifecycle Model:
- skills-tracks/rri/rri-101-index.md
- What is the Project Lifecycle?: skills-tracks/rri/rri-101-1.md
- Project Design: skills-tracks/rri/rri-101-2.md
- Model Development: skills-tracks/rri/rri-101-3.md
- System Deployment: skills-tracks/rri/rri-101-4.md
- The SAFE-D Modules:
- skills-tracks/rri/rri-200-index.md
# - Sustainability:
# - skills-tracks/rri/rri-201-index.md
# - Accountability:
# - skills-tracks/rri/rri-202-index.md
- Fairness:
- skills-tracks/rri/rri-203-index.md
- What is Fairness?: skills-tracks/rri/rri-203-1.md
- Sociocultural Fairness: skills-tracks/rri/rri-203-2.md
- Statistical Fairness: skills-tracks/rri/rri-203-3.md
- Identifying and Mitigating Bias: skills-tracks/rri/rri-203-4.md
- Explainability:
- skills-tracks/rri/rri-204-index.md
- What is Explainability?: skills-tracks/rri/rri-204-1.md
- Project Transparency: skills-tracks/rri/rri-204-2.md
- Model Interpretability: skills-tracks/rri/rri-204-3.md
- Situated Explanations: skills-tracks/rri/rri-204-4.md
# - Data Stewardship:
# - skills-tracks/rri/rri-205-index.md
# - Responsible Communication:
# - skills-tracks/rri/rri-300-index.md
- Public Engagement in Data Science and AI:
- skills-tracks/ped/index.md
- What is Public Engagement?:
- Introduction: skills-tracks/ped/chapter1/index.md
- Climbing the Ladder: skills-tracks/ped/chapter1/ladder.md
- Goals of Public Engagement: skills-tracks/ped/chapter1/goals.md
- The Value(s) of Public Engagement:
- Introduction: skills-tracks/ped/chapter2/index.md
- Deliberative Values: skills-tracks/ped/chapter2/deliberation.md
- Responsible Public Engagement: skills-tracks/ped/chapter2/responsible.md
- Facilitating Public Engagement:
- Introduction: skills-tracks/ped/chapter3/index.md
- When should you engage: skills-tracks/ped/chapter3/when.md
- How should you engage: skills-tracks/ped/chapter3/how.md
- Practical Guidance:
- Introduction: skills-tracks/ped/chapter4/index.md
- Storytelling with Data: skills-tracks/ped/chapter4/storytelling.md
- Communicating Uncertainty: skills-tracks/ped/chapter4/uncertainty.md
- Visualising Uncertainty: skills-tracks/ped/chapter4/uncertainty-example.md
- Public Trust and Assurance:
- Introduction: skills-tracks/ped/chapter5/index.md
- Public Trust in Science and Technology: skills-tracks/ped/chapter5/trust.md
- AI Ethics and Governance:
- skills-tracks/aeg/index.md
- Practical Ethics:
- Introduction: skills-tracks/aeg/chapter1/index.md
- Introduction to Metaethics: skills-tracks/aeg/chapter1/metaethics.md
- Introduction to Normative Theories: skills-tracks/aeg/chapter1/normative.md
- AI Harms and Values:
- Introduction: skills-tracks/aeg/chapter2/index.md
- AI Harms: skills-tracks/aeg/chapter2/harms.md
- AI Values: skills-tracks/aeg/chapter2/values.md
- AI Sustainability:
- Introduction: skills-tracks/aeg/chapter3/index.md
- Stakeholder Engagement Process: skills-tracks/aeg/chapter3/engagement.md
- Stakeholder Impact Assessment: skills-tracks/aeg/chapter3/impact.md
- Fairness & Bias Mitigation, Accountability, and Governance:
- Introduction: skills-tracks/aeg/chapter4/index.md
- Introduction to Fairness: skills-tracks/aeg/chapter4/fairness.md
- AI Fairness: skills-tracks/aeg/chapter4/aifairness.md
- Bias Mitigation: skills-tracks/aeg/chapter4/bias.md
- Accountability: skills-tracks/aeg/chapter4/accountability.md
- AI Governance: skills-tracks/aeg/chapter4/governance.md
- Transparency, Explainability, and CARE and ACT Principles:
- Introduction: skills-tracks/aeg/chapter5/index.md
- Transparency & Explainability: skills-tracks/aeg/chapter5/transparency.md
- Consider Context: skills-tracks/aeg/chapter5/consider.md
- Anticipate Impacts: skills-tracks/aeg/chapter5/anticipate.md
- Reflect on Purpose, Positionality, and Power: skills-tracks/aeg/chapter5/reflect.md
- Engage Inclusively: skills-tracks/aeg/chapter5/engage.md
- Act Responsibly: skills-tracks/aeg/chapter5/act.md
- Data Justice:
- skills-tracks/dj/index.md
- Introduction to Data Justice:
- skills-tracks/dj/dj-100-index.md
- What is Data Justice?: skills-tracks/dj/dj-100-1.md
- A brief history of data justice literature: skills-tracks/dj/dj-100-2.md
- Second-Wave Data Justice Research and Practice: skills-tracks/dj/dj-100-3.md
- Resources:
- resources/index.md
- Gallery: resources/gallery.md
- Bibliographies: resources/bibliographies.md
- Case Studies: resources/case-studies.md
- Activities: resources/activities.md
- Blog:
- blog/index.md