mafoo.org.uk/selfdefined
1
0
Fork 0
mirror of https://github.com/fooflington/selfdefined.git synced 2025-01-22 09:20:00 +00:00
Code Issues Projects Releases Wiki Activity

⚒️ Adds content warning guidelines page (#200)

Browse Source 
* Add empty page content file

* Add link in footer

* Make footer links span two columns when in grid template layout

* wrap footer grid-column in media query to strip triggering 2 columns on mobile

* Add guidelines content

* Capitalise 'Warning'

* Add link to guidance page from guidance definition block

* Change 'term' to 'topic'

* Update 11ty/content-warning-guidelines/index.md

Co-authored-by: Tatiana Mac <github@tatianamac.com>

* Update 11ty/content-warning-guidelines/index.md

Co-authored-by: Tatiana Mac <github@tatianamac.com>

* Update 11ty/content-warning-guidelines/index.md

Co-authored-by: Tatiana Mac <github@tatianamac.com>

* Update 11ty/content-warning-guidelines/index.md

Co-authored-by: Tatiana Mac <github@tatianamac.com>

* Update 11ty/content-warning-guidelines/index.md

Co-authored-by: Tatiana Mac <github@tatianamac.com>

* remove additional line breaks to pass lint tests

* remove my now unneeded media query

* Remove longer content warning from definition page

* Change content warning flag to link to separate content warning guidance page

* remove unneeded content flag styling

Co-authored-by: Tatiana Mac <tatiana.t.mac@gmail.com>
Co-authored-by: Tatiana Mac <github@tatianamac.com>
This commit is contained in:
Matthew Shields 2020-06-20 19:06:01 +01:00 committed by GitHub
parent a33c5fe86e
commit f72d41280a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 57 additions and 64 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
11ty/_includes/components/content-warning-flag.njk
View File

@ -3,13 +3,13 @@
flag.text and
(flag.level == 'avoid') -%}
<div class="u-margin-bottom-double content-flag content-flag--avoid">
<p class="small">We would recommend adding a content warning when speaking about this term. Please <a href="#content-warning-guide">read the guidance</a> on how and when to warn people before using this term in any context.</p>
<p class="small">We would recommend adding a content warning when speaking about this term. Please <a href="/content-warning-guidelines/">read the guidance</a> on how and when to warn people before using this term in any context.</p>
</div>
{%- elseif
flag and
flag.text and
(flag.level == 'warning') -%}
<div class="u-margin-bottom-double content-flag">
<p class="small">There is a content warning against this term, we would recommend <a href="#content-warning-guide">reading the guidance</a> on warning other people before using this term in any context.</p>
<p class="small">We would recommend adding a content warning when speaking about this term. Please <a href="/content-warning-guidelines/">read the guidance</a> on how and when to warn people before using this term in any context.</p>
</div>
{% endif %}

47
11ty/_includes/components/content-warning.njk
View File

@ -1,47 +0,0 @@
{%- if
flag and
flag.text and
(flag.level == 'avoid') -%}
<div class="u-margin-bottom-double u-margin-top-double content-warning content-warning--avoid" id="content-warning-guide">
<p>You may want to add a content warning before discussing or showing imagery involving this topic, as it is a topic that can elicit unnecessary harm through inducing negative feelings, anxiety, or trauma.</p>
<p>
<strong>Content warnings usually take the form of "Content warning:
{{ title }}" or "CW:
{{ title }}. We recommend the former when possible.</strong>
</p>
<p>Content warnings should be given at the earliest possible opportunity. Examples of where you can do this are:</p>
<ul class="list-default">
<li>Articles under the byline, before content</li>
<li>Videos (with proper audio descriptions)</li>
<li>Photographs (with proper alt text)</li>
<li>Podcasts (before topic, in transcript)</li>
<li>Books (introductory page, summary)</li>
<li>Conference talks/webinars</li>
<li>Start of social media posts including this term</li>
<li>Social media posts with a link to content including this term</li>
</ul>
</div>
{%- elseif
flag and
flag.text and
(flag.level == 'warning') -%}
<div class="u-margin-bottom-double u-margin-top-double content-warning" id="content-warning-guide">
<p>You may want to add a content warning before discussing or showing imagery involving this topic, as it is a topic that can elicit unnecessary harm through inducing negative feelings, anxiety, or trauma.</p>
<p>
<strong>Content warnings usually take the form of "Content warning:
{{ title }}" or "CW:
{{ title }}. We recommend the former when possible.</strong>
</p>
<p>This content warning should be given at the earliest possible opportunity. Examples of where you can do this are:</p>
<ul class="list-default">
<li>Articles under the byline, before content</li>
<li>Videos (with proper audio descriptions)</li>
<li>Photographs (with proper alt text)</li>
<li>Podcasts (before topic, in transcript)</li>
<li>Books (introductory page, summary)</li>
<li>Conference talks/webinars</li>
<li>Start of social media posts including this term</li>
<li>Social media posts with a link to content including this term</li>
</ul>
</div>
{% endif %}

4
11ty/_includes/layouts/base.njk
View File

@ -25,7 +25,9 @@
<li>
<a href="/documentation/">Documentation</a>
</li>
&bull;
<li>
<a href="/content-warning-guidelines/">Content Warning Guidelines</a>
</li>
<li>
<a href="{{ metadata.feedPermalink | absoluteUrl(metadata.url) }}">RSS Feed</a>
</li>

1
11ty/_includes/layouts/definition.njk
View File

@ -18,7 +18,6 @@
</header>
{% include 'components/content-warning-flag.njk' %}
{% include 'components/definition-content.njk' %}
{% include 'components/content-warning.njk' %}
{% renderDefinitionContentNextEntries title, slug, collections.definedWords %}
</article>
</main>

3
11ty/content-warning-guidelines/content-warning-guidelines.json Normal file
View File

@ -0,0 +1,3 @@
{
"layout": "layouts/documentation.njk"
}

49
11ty/content-warning-guidelines/index.md Normal file
View File

@ -0,0 +1,49 @@
---
title: Content Warning Guidelines
---
There are a wide variety of topics that can cause unnecessary harm to people, inducing negative feelings, anxiety, or trauma. The goal of Content Warnings or Trigger Warnings is to allow the audience to prepare themselves, or if they choose to, avoid the topic completely.
## What is the difference between a Content Warning and a Trigger Warning
Content warnings and trigger warnings are sometimes used interchangeably to warn the reader/user when a topic that may cause an undesirable feeling or reaction. We opt to use content warning as trigger warning is more specific (and makes the assumption that the reader/user will be triggered).
## When to give a Content Warning
Any time that you discuss a topic that you believe may cause a negative reaction for anyone, at any scale, then it would be best to give a content warning. It is best to try and think objectively about this, rather then just through the spectrum of your own personal experience and triggers.
To help with this, definitions on Self Defined will advise you when we recommend that you give a content warning. If you are ever in doubt though, we would recommend to side on deciding to give a warning rather than not.
## How to give a Content Warning
There are two standardised ways of giving a content warning in writing:
<ul class="list-default">
<li>Content Warning: [topic or topics]</li>
<li>CW: [topic or topics]</li>
</ul>
We would recommend that wherever possible you choose the first full text example. This will ensure that people who may not be familiar with the acronym of CW will still fully understand. In the case of media such as video, it is vital that it is given in a way that everyone will be able to access it, including through audio and visual cues.
When describing the topics, you want to ensure that you give someone the opportunity to decide whether to continue, but be careful not to describe in a way that the content warning itself could also be traumatic when read.
## Where to give a Content Warning
In order to give someone a chance to decide to engage with a possibly distressing topic or not, a content warning should be given at the earliest possible opportunity.
**Examples of where you can do this are:**
<ul class="list-default">
<li>Articles under the byline, before content</li>
<li>Videos (with proper audio descriptions)</li>
<li>Photographs (with proper alt text)</li>
<li>Podcasts (before topic, in transcript)</li>
<li>Books (introductory page, summary)</li>
<li>Conference talks/webinars (introduction)</li>
<li>Start of social media posts including this topic</li>
<li>Social media posts with a link to content including this topic</li>
</ul>
## Responding to feedback
Even taking this on board, someone may feed back to you saying that your content caused them a negative reaction. If this happens, please wherever possible amend your content warning as possible. The goal of content warnings is to reduce as much harm as possible, and it's never too late to start.

13
assets/css/components/_definitions.scss
View File

@ -41,16 +41,3 @@
}
}
}
.content-warning {
background-color: $lt-background-color-warning;
border-left: 4px $yellow solid;
overflow: hidden;
padding: 1rem 1.5rem;
position: relative;
&--avoid {
background-color: $pink;
border-left-color: red;
}
}