Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merge gh-pages branch with master branch to update content #5

Open
wants to merge 114 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
114 commits
Select commit Hold shift + click to select a range
e0f2d2d
Update CNAME
tplagge Jul 15, 2020
9504a5b
Separate intros for each playbook
tplagge Jul 15, 2020
a7fa70b
Merge branch 'gh-pages' of https://github.com/brighthive/playbooks in…
tplagge Jul 15, 2020
3e978f2
Update index and titles, remove stale files
tplagge Jul 15, 2020
0a7838d
Add Apache license
tplagge Jul 15, 2020
45ee249
Update CNAME
tplagge Jul 15, 2020
259e18f
Update CNAME
tplagge Jul 15, 2020
d833eae
Delete CNAME
tplagge Jul 15, 2020
3a5b629
Create CNAME
tplagge Jul 15, 2020
3d65089
Prep for initial release
tplagge Jul 16, 2020
42a332f
Tweaks to pre-release version
tplagge Jul 16, 2020
a89115d
Make titles consistent
tplagge Jul 16, 2020
7924d02
Upload of DCTT content
hpassen Jul 16, 2020
a92fb19
Upload DCTT Content
hpassen Jul 16, 2020
6faaf60
Jobseekers Initial Upload
hpassen Jul 16, 2020
4910152
Formatting Intial Upload
hpassen Jul 16, 2020
4e2e3df
Formatting Initial Upload
hpassen Jul 16, 2020
12e48c9
Merge branch 'gh-pages' into dctt_upload
tplagge Jul 17, 2020
32f2ca0
Merge pull request #3 from brighthive/dctt_upload
tplagge Jul 17, 2020
88a41cc
Point to Hana's introduction text
tplagge Jul 17, 2020
fdbd88a
Remove stale intro placeholder
tplagge Jul 17, 2020
5152afa
Add play types
tplagge Jul 17, 2020
ade873c
Show play type along with play number
tplagge Jul 17, 2020
f680e99
Split into two categories
tplagge Jul 17, 2020
5fbd59d
Split tables of contents into separate divs
tplagge Jul 17, 2020
b0905dd
Remove extra line break
tplagge Jul 17, 2020
76e50c7
Merge branch 'gh-pages' into jobseeker_upload
tplagge Jul 17, 2020
c54e060
Merge branch 'jobseeker_upload' into gh-pages
tplagge Jul 17, 2020
7e618ca
Point to Hana's jobseeker tools intro text
tplagge Jul 17, 2020
e46e505
Update 01.md
tplagge Jul 17, 2020
b1e54e5
Remove margin from bottom of h6
tplagge Jul 17, 2020
a0a8c79
Merge branch 'gh-pages' of https://github.com/brighthive/playbooks in…
tplagge Jul 17, 2020
ffe1a17
Remove padding for H3s
tplagge Jul 17, 2020
7ff03cf
Padding at the top of subheaders
tplagge Jul 17, 2020
a920e3d
Trigger gh-pages rebuild
tplagge Jul 17, 2020
2b9df99
added disclaimer
hpassen Jul 17, 2020
3b4281b
added disclaimer
hpassen Jul 17, 2020
9a7f76d
Updated Section Headers
hpassen Jul 17, 2020
77d8546
formatting update
hpassen Jul 17, 2020
62d7b79
more style
hpassen Jul 17, 2020
cc2164b
Updated Formatting Jobseekers Playbook
hpassen Jul 17, 2020
829d803
Updated formatting DCTT Playbook
hpassen Jul 17, 2020
a98b14d
Updated Formatting and Design
hpassen Jul 17, 2020
f4fff93
Formatting and Design
hpassen Jul 17, 2020
dfb29e2
Testing formatting
hpassen Jul 17, 2020
873b904
More formatting
hpassen Jul 17, 2020
c2b375e
Updating the subheadings format
hpassen Jul 17, 2020
d4c8ee4
Updated colors, font sizing in lists
hpassen Jul 20, 2020
9287c29
Font sizing
hpassen Jul 20, 2020
f3dadb6
reversed font sizing changes
hpassen Jul 20, 2020
2ce38e9
Updated Logos
hpassen Jul 20, 2020
975f0f5
Updated Logos
hpassen Jul 20, 2020
e856feb
Favicon Update
hpassen Jul 20, 2020
b7148d8
Update index.html
tplagge Jul 20, 2020
76b7417
Favicon Update
hpassen Jul 20, 2020
054cdbf
Merge branch 'gh-pages' of github.com:brighthive/playbooks into gh-pages
hpassen Jul 20, 2020
73575c8
updated colors
hpassen Jul 20, 2020
fd9a6fc
Update styles to fix footnote numbering
tplagge Jul 20, 2020
2f391ba
Update styles.scss
tplagge Jul 20, 2020
18cd4fb
Widen text
tplagge Jul 20, 2020
ea87504
Update index text
tplagge Jul 20, 2020
a586807
Widen titles
tplagge Jul 20, 2020
89b5fd3
Update index.html
tplagge Jul 20, 2020
450b022
Update styles.scss
tplagge Jul 20, 2020
d3ec26f
Update index.html
tplagge Jul 20, 2020
05b238a
Update index.html
tplagge Jul 20, 2020
0ec6e73
Update index.html
tplagge Jul 20, 2020
5ea9f32
Update index.html
tplagge Jul 20, 2020
98d7306
Update index.html
tplagge Jul 20, 2020
9fdca22
Update contact_tracing_intro.md
tplagge Jul 20, 2020
8e8c96a
Add dummy pdfs
tplagge Jul 20, 2020
8dfdeb4
Update index.html
tplagge Jul 20, 2020
93c59eb
Update index.html
tplagge Jul 20, 2020
51cf054
Update jobseeker_tools_intro.md
tplagge Jul 20, 2020
ef865e3
Update index.html
tplagge Jul 20, 2020
bac93b7
Update index.html
tplagge Jul 20, 2020
7ac14ab
PDFs Uploaded
hpassen Jul 20, 2020
4edcd69
Ready to Launch
hpassen Jul 20, 2020
bece252
Updated for Social Media
hpassen Jul 21, 2020
7cf7831
Updated for Social Media
hpassen Jul 21, 2020
a39a01f
Add Google Analytics tracking
tplagge Jul 21, 2020
2794637
Updated next steps
hpassen Jul 21, 2020
59033f6
Merge branch 'gh-pages' of github.com:brighthive/playbooks into gh-pages
hpassen Jul 21, 2020
14c53e1
Updated Next Steps
hpassen Jul 21, 2020
1eef687
updated landing page
hpassen Jul 21, 2020
6d74645
Update google-analytics.html
tplagge Jul 21, 2020
fdff695
Update index.html
tplagge Jul 21, 2020
cc9938b
Update index.html
tplagge Jul 21, 2020
005aa51
Update index.html
tplagge Jul 21, 2020
ece9f42
updated titles
hpassen Jul 21, 2020
7c7c7cd
Merge branch 'gh-pages' of github.com:brighthive/playbooks into gh-pages
hpassen Jul 21, 2020
61bfcc1
Updated Names, CC License
hpassen Aug 10, 2020
f740377
Formatting for CC License
hpassen Aug 10, 2020
87219d0
Formatting for CC License
hpassen Aug 10, 2020
77e84a6
Updated PDFs and Formatting
hpassen Aug 10, 2020
e697c2e
Linebreaks
hpassen Aug 10, 2020
76a4959
Update gems to address kramdown vuln
tplagge Aug 10, 2020
5d9b8ec
Updates after MIT Publication
hpassen Sep 9, 2020
a02a623
Merge branch 'gh-pages' of github.com:brighthive/playbooks into gh-pages
hpassen Sep 9, 2020
6a41211
Testing Formatting Updates
hpassen Sep 9, 2020
54593b7
Create test_file.md
hpassen Sep 10, 2020
065d7dc
Delete test_file.md
hpassen Sep 10, 2020
7d7c42e
Creating a test play
hpassen Sep 11, 2020
288e144
Delete 08.md
hpassen Sep 11, 2020
5cde4ef
updated playbook pdfs
Nov 17, 2020
7ca7a40
Updated with the new logo and color
siyoungbyun Nov 17, 2020
91cb7cb
updated fonts
siyoungbyun Nov 19, 2020
175a7de
updated pdfs with new font
siyoungbyun Nov 19, 2020
82f53a9
Updated font size and padding for headers
siyoungbyun Nov 19, 2020
a6d3b0b
Decreased font size for play headers
siyoungbyun Nov 19, 2020
85d626c
modified the links for the call to action
siyoungbyun Dec 16, 2020
ba5da81
updated pdfs with modified links
siyoungbyun Dec 16, 2020
613a2cb
changed BrightHive to Brighthive
siyoungbyun Dec 16, 2020
f009e8a
rearranged 'Take the Next Step' section
siyoungbyun Dec 17, 2020
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CNAME
Original file line number Diff line number Diff line change
@@ -1 +1 @@
playbooks.brighthive.io
playbooks.brighthive.io
6 changes: 3 additions & 3 deletions Gemfile
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
source 'https://rubygems.org'
gem 'github-pages'
gem 'sass', '~>3.4.22'
gem 'bourbon', '~>4.0.2'
gem 'neat', '~>1.6.0'
gem "jekyll", "~> 3.7.4"
gem 'bourbon', '~>7.0.0'
gem 'neat', '~>4.0.0'
gem "jekyll", "~> 3.9.0"
201 changes: 201 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,201 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.

"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:

(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.

You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright [yyyy] [name of copyright owner]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,4 +30,4 @@ To run the site locally, run `jekyll serve --watch`, then visit `http://localhos
This project uses [Sass](http://sass-lang.com/ "Link to Learn More About Sass") for managing its style sheets. These styles are defined in the [`styles.scss` file](assets/_sass/styles.scss). We use [Jekyll's native SASS support](https://jekyllrb.com/docs/assets/) to auto-generate the required CSS when you run the site locally, as described above.

## License
Insert license here. Original playbook is public domain.
Apache 2.0
1 change: 1 addition & 0 deletions _config.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
permalink: pretty
highlighter: rouge
url: https://playbooks.brighthive.io
google_analytics: UA-153784380-1

collections:
- contact_tracing_plays
Expand Down
27 changes: 10 additions & 17 deletions _contact_tracing_plays/01.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,18 @@
---
play_number: 1
title: Understand what people need
play_type: FOUNDATIONAL AND ORGANIZATIONAL
title: Follow the lead of public health experts and use evidence-based solutions
---

We must begin digital projects by exploring and pinpointing the needs of the people who will use the service, and the ways the service will fit into their lives. Whether the users are members of the public or government employees, policy makers must include real people in their design process from the beginning. The needs of people — not constraints of government structures or silos — should inform technical and design decisions. We need to continually test the products we build with real people to keep us honest about what is important.
It is essential that members of a DCTT initiative coalition work with medical and public health partners to understand their data needs. Decisions about which data, analytic, and technological models to pursue should be based on medical and public health partners’ needs, their estimates of efficacy, and should be grounded in the best available evidence.

### Checklist
1. Early in the project, spend time with current and prospective users of the service
2. Use a range of qualitative and quantitative research methods to determine people’s goals, needs, and behaviors; be thoughtful about the time spent
3. Test prototypes of solutions with real people, in the field if possible
4. Document the findings about user goals, needs, behaviors, and preferences
5. Share findings with the team and agency leadership
6. Create a prioritized list of tasks the user is trying to accomplish, also known as "user stories"
7. As the digital service is being built, regularly test it with potential users to ensure it meets people’s needs
1. Ensure DCTT uses and limitations have been taken into account, documented, and mitigated where appropriate, before implementation.
2. Continuously monitor the state of DCTT performance across various contexts, including monitoring for new research or evidence, alternative technologies, or unintended consequences (such as negative impacts on public health goals or unfair advantages or disadvantages for certain communities).
3. Commit to limiting the scope of the DCTT initiative according to the advice of public health experts, including policies for dissolution of activities that: a) prove to be poorly validated or ineffective by epidemiologist or expert assessment for controlling the pandemic or infection chains, or b) exceed the scope of its intended public health purpose to reduce the transmission of COVID-19.

### Key Questions
- Who are your primary users?
- What user needs will this service address?
- Why does the user want or need this service?
- Which people will have the most difficulty with the service?
- Which research methods were used?
- What were the key findings?
- How were the findings documented? Where can future team members access the documentation?
- How often are you testing with real people?
- Has the DCTT implementation been assessed by epidemiological experts? Has it been assessed against generally acceptable contact tracing privacy standards and principles?
- How have limitations to DCTT been identified and addressed (including limitations related to accuracy, relevance, power, and interoperability with epidemiological models)?
- How will the DCTT system’s performance be monitored and evaluated?
- What is the process to modify or terminate DCTT activities if they are found to be ineffective or at risk of exceeding their original scope?
26 changes: 15 additions & 11 deletions _contact_tracing_plays/02.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,23 @@
---
play_number: 2
title: Address the whole experience, from start to finish
play_type: FOUNDATIONAL AND ORGANIZATIONAL
title: Decision-makers should be guided by necessity, proportionality, and purpose limitations
---

We need to understand the different ways people will interact with our services, including the actions they take online, through a mobile application, on a phone, or in person. Every encounter — whether it's online or offline — should move the user closer towards their goal.
Measures taken in response to pandemics should be necessary and proportionate, to ensure that responses will be beneficial to solving the crisis without undue infringement on individual privacy and civil rights. Any personal information collected and used to control the harmful effects and spread of a pandemic should be strictly time-limited and confined to a specific, well-defined public health purpose. Historical evidence suggests that it is difficult to discontinue practices initiated during an emergency, and that proactive measures are required to avoid “mission creep.” Coalitions seeking to use personal information to control the harmful effects and spread of a pandemic should ask themselves whether or not a specific measure constitutes a necessary, appropriate, and proportionate action within a democratic society.

### Checklist
1. Understand the different points at which people will interact with the service – both online and in person
2. Identify pain points in the current way users interact with the service, and prioritize these according to user needs
3. Design the digital parts of the service so that they are integrated with the offline touch points people use to interact with the service
4. Develop metrics that will measure how well the service is meeting user needs at each step of the service

1. Establish an exit strategy up front to protect against continued “emergency practices” after the end of the public health crisis.
2. Proactively identify and mitigate risks of mission creep and new or unanticipated uses of personal information.
3. Deploy DCTT in the least intrusive way and handle personal information at the lowest level of identifiability and scale necessary to accomplish stated public health goals.
4. Clearly articulate the specific risks and benefits to individuals and the public that are created by the DCTT.
5. Collect only the personal information strictly necessary to accomplish stated public health goals and nothing more.

### Key Questions
- What are the different ways (both online and offline) that people currently accomplish the task the digital service is designed to help with?
- Where are user pain points in the current way people accomplish the task?
- Where does this specific project fit into the larger way people currently obtain the service being offered?
- What metrics will best indicate how well the service is working for its users?
- Which medical and public health experts were consulted to determine the types of personal information necessary to accomplish specific public health goals?
- How were the anticipated impacts of the DCTT identified and weighed to ensure that potential risks to individuals and society are proportionate to the potential benefits?
- Are there components of the DCTT service for which aggregate information or summary statistics, rather than individual or identifiable information, are sufficient?
- If there are multiple options for implementing certain DCTT components or functionalities, which is the most privacy-preserving that still accomplishes stated public health goals?
- If personal data is shared with partners or service providers, are there equally strict limitations on its duration and use by other entities?
- Who will proactively audit DCTT data systems to ensure that data is not used beyond the original purposes and stated public health goals for which it was collected?
- How will personal information and DCTT services be safely and securely shut down when no longer needed, or when the public health emergency has ended?
Loading