Merge pull request #66 from numfocus/langauageTool

Checking readability with LanguageTool (WIP)

DISCOVER/01_about.md

@@ -18,7 +18,7 @@ This cookbook is **not** intended to provide **general instructions** on how to
 
 Some "basic" best practice is understood to be a prerequisite for many of our recommendations. For example, live-captioning support for the hearing-impaired is not possible without reliable internet and good A/V setup. In general, we have avoided explicitly calling out these implied dependencies in order to maintain focus and keep the cookbook to a more manageable length.
 
-This cookbook also does not offer reasons or rationale for **why inclusion and diversity are important**. The cookbook presumes the organizing committee is already interested in improving diversity and inclusion at their conference or event, hence the suggestions herein are focused on the "how" rather than the "why".
+This cookbook also does not offer reasons or rationale for **why inclusion and diversity are important**. The cookbook presumes the organizing committee is already interested in improving diversity and inclusion at their conference or event. Hence the suggestions herein are focused on the "how" rather than the "why".
 
 
 ## Acknowledgements:
@@ -43,7 +43,7 @@ We sincerely appreciate the efforts and input of the many individuals who contri
 ## Special Considerations Depending on Geographic Context
 
 - Most of the material contained herein is written from the U.S. perspective (e.g. Americans with Disabilities Act (ADA) protections). 
-- Something to be aware of: some U.S. states may have discriminatory laws in place which could affect whether or not you should choose to host an event or conference there. 
+- Something to be aware of: some U.S. states may have discriminatory laws in place which could affect whether you should choose to host an event or conference there. 
 - We welcome input on considerations for events and conferences in other countries.
 - Additional considerations may need to be made for very remote event locations with no public transit, e.g. for folks who are mobility impaired.
 

DISCOVER/02_minimal_measures.md

@@ -6,12 +6,12 @@
 Making your conference inclusive and encouraging diversity is achievable. The measures below are explained in more depth in the other pages of this Cookbook.
 
 ## What are the easiest and most impactful measures?
- 
+
  Just follow the measures below. They are explained in more depth in the other pages of this Cookbook. Measures that are **easy to implement** and have a **strong positive impact** are "low-hanging fruit" and marked with a red apple emoji: 🍎. Measures that take more effort but have considerable impact are marked with a green checkmark: ✅.
 
 
 ## [Organizing Committee](03_organizing_committee.md)
-✅ The organizing committee itself should reflect the diversity you want to create in your conference! 
+✅ The organizing committee itself should reflect the diversity you want to create in your conference!
 Prioritizing diversity starts with you.
 
 Conference chairs and lead organizers should take special care to recruit an organizing committee that reflects the diversity of the event you aspire to create.
@@ -21,79 +21,79 @@ Conference chairs and lead organizers should take special care to recruit an org
 ### Accessibility Considerations
 
 -   Consider attendees who may need accommodations for a disability
-    
+
 
 ####  Mobility
 
--   🍎 Reserve seats in rooms for folks who might need it (wheelchair, crutches, cane, etc.). Choose easily-accessible seats, such as at the end of a row on the aisle.
-    
+-   🍎 Reserve seats in rooms for folks who might need it (wheelchair, crutches, cane, etc.). Choose easily accessible seats, such as at the end of a row on the aisle.
+
 -   🍎 Create wide aisles between chairs to make it easier for people who are mobility-impaired to navigate the room.
-    
+
 
 #### Disability
 
 -   🍎 Provide large-text signs and easy-to-read maps. Ask conference organizers to announce important information over the microphone, which helps people with impaired vision.
 
 - ✅ Book sign-language interpreters and/or real-time captioning (someone typing captions) for deaf and hard-of-hearing attendees.**
-    
+
 
 ### Bathrooms
 
 #### Gender-Neutral Bathrooms
 
 -   🍎 Post signs in the restroom and/or on the door instructing what to do if you think someone is in the "wrong" restroom
-    
+
 
 	-   "If you think someone's gender doesn't match the sign on the door, please follow these steps: Don't worry about it, they know better than you." (via [@LGBTplusBristol](https://twitter.com/lgbtplusbristol))
-	
+
 - ✅ Ensuring your conference has easily accessible gender-neutral restrooms is a simple way to help non-binary and trans individuals feel included and welcome at your conference.**
-    
+
 
 #### Toiletries/Supplies
 
 -   🍎 Provide tampons and pads in all restrooms (some people who identify as male have periods and may need them)
-    
+
 
 ### 🍎 Dedicated rooms
 
 -   The rooms should be clearly labeled to prevent accidental entry, and their locations should be provided in both the print and the online conference directory and maps.
-    
+
 -   Don't allow anyone (even organizers) to use the room for other purposes.
-    
+
 
 #### 🍎 Nursing & Pumping Room
 
 -   Ensure there is a dedicated, single-occupancy space with lock.
-    
+
 -   For the room to be optimally useful, these things are desired:
 
-    -   Locking door, Comfortable chair, a desk or table next to the chair (to set the pump, bottles, etc. on), no more than 4 feet from the nearest electrical outlet, cleaning wipes, paper towels, and a garbage can, masking tape and a marker for labeling milk bottles and pump parts, close proximity to a sink for hand washing and washing of pump parts, a refrigerator for storage of pumped milk  in the pumping room or nearby, dim lighting
+    -   Locking door, Comfortable chair, a desk or table next to the chair (to set the pump, bottles, etc. on), no more than 4 feet from the nearest electrical outlet, cleaning wipes, paper towels, and a garbage can, masking tape and a marker for labeling milk bottles and pump parts, proximity to a sink for hand washing and washing of pump parts, a refrigerator for storage of pumped milk  in the pumping room or nearby, dim lighting
 
 #### 🍎 Gender-Neutral Bottle Feeding Room
 
 -   Bottle-fed babies can be fed by caregivers of any gender and also benefit from a quiet, low-distraction, private space for feeding.
-    
--   This should be a separate, additional room ( NOT the same as the nursing and pumping room ) which should be clearly labelled. It could accommodate multiple babies at a time and be equipped with: multiple comfortable chairs with broad armrests to facilitate bottle feeding positions, a bottle warmer, paper towels, cleaning wipes and garbage can for cleanliness, dim lighting and in a quiet area of the conference center/venue
-    
+
+-   This should be a separate, additional room (NOT the same as the nursing and pumping room) which should be clearly labeled. It could accommodate multiple babies at a time and be equipped with multiple comfortable chairs with broad armrests to facilitate bottle feeding positions, a bottle warmer, paper towels, cleaning wipes and garbage can for cleanliness, dim lighting and in a quiet area of the conference center/venue
+
 
 #### 🍎 Quiet Room
 
 -   A dedicated room for people who need a break from the stimulation of being surrounded by people at the conference; no phone calls, talking/socializing, notification beeps! People whose religions require frequent prayer can make use of the quiet room.
 
 -   Consider "quiet areas" if a separate room is not possible.
-    
+
 ## [Catering](05_catering.md)
 
 Making sure that your attendees have something they can eat at mealtimes is an important element of building an inclusive and welcoming conference.
 
 -   Best to have a sign/small label in front of each dish with a list of ingredients and common labels (e.g. "gluten-free, vegan, includes peanuts").
-    
+
 
 	-   🍎 Ask your caterer to create and provide the labels.
-    
+
 
 -   🍎 Make sure to include a variety of beverages, in particular non-alcoholic and non-caffeinated.
--   ✅ Common dietary needs to plan for: gluten free, dairy free, vegan, vegetarian, pork free, shellfish free, soy free, nut free - especially peanut (this is usually a serious allergy so take extra care), kosher, halal
+-   ✅ Common dietary needs to plan for gluten-free, dairy-free, vegan, vegetarian, pork-free, shellfish-free, soy-free, kosher, halal, nut-free. Shellfish and peanut  especially are usually a serious allergy so take extra care.
 
 ## [Code of Conduct (CoC)](07_code_of_conduct.md)
 
@@ -104,15 +104,15 @@ Make sure that everyone involved in your conference/event is aware that the CoC
 -   🍎 Tick box at registration that confirms that the participant has read it
 
 -   🍎 Include a copy of the CoC in the sponsor packet
-    
+
 -   🍎 Mention that the CoC applies to the speakers in the speaker guidelines
-    
+
 -   🍎 Ensure that CoC is easily accessible on the conference website
 
 -   🍎 Include a short version on the printed schedule as a reminder
-    
--   🍎 Mention it in the welcome talk and at the start of every day, including who to contact if there is a problem/violation
-    
+
+-   🍎 Mention it in the welcome talk and at the start of every day, including whom to contact if there is a problem/violation
+
 
 ## [Participant and Speaker Selection](09_participant_selection.md)
 
@@ -126,54 +126,54 @@ Make sure that everyone involved in your conference/event is aware that the CoC
 #### Selecting Speakers
 
 -   🍎 Call For Proposals instructions -- be clear who you want
-    
+
 	-   In the solicitation, be transparent that you want a broad & diverse group to share their expertise.
-    
+
 	-   Let applicants know what criteria will be used to assess their submission and how speakers will be chosen.
-
 
-	-   If your conference has a long history and you're trying to change what it's like, be up front about the kinds of people you want to have speak, why, and how this may look different from years past.
-
+
+	-   If your conference has a long history, and you're trying to change what the program make-up, be up front about the kinds of people you want to have speak, why, and how this may look different from years past.
+
 
 #### Call for Proposals Review
 
--   ✅ There are many approaches to reviewing and selecting conference contributions and there is no foolproof type of review that always avoids biases. Regardless of which approach you choose, open or anonymized, we encourage you to make it "double" so that both parties know each other (double-open) or neither party knows the other (double-closed)
-    
+-   ✅ There are many approaches to reviewing and selecting conference contributions, and there is no foolproof type of review that always avoids biases. Regardless of which approach you choose, open or anonymized, we encourage you to make it "double" so that both parties know each other (double-open) or neither party knows the other (double-closed)
+
 
 
 ### Attracting Attendees
 
 -   🍎 Pay attention to the photos you use to advertise your event—what do people look like who attend?
-    
+
 
 ## [Event Registration](10_event_registration.md)
 What to ask on your registration form (and what not to ask)
 
 ### Preparing to meet accessibility needs
 
 -   🍎 Ask registrants if they have any additional accessibility needs, and if so, provide instructions on how to make the request.
-    
+
 
 	-   "Do you need any special accommodations to help make your time at the conference comfortable and productive? (e.g. accessibility considerations). Please [email](mailto:[email protected]) and include the details of your request."
 
 ### Demographic Info
 
 -   ✅ If you do collect demographic info, be thoughtful about the structure of the questions so that they are inclusive and don't contribute to alienating or "othering" marginalized people.
-    
+
 
 	-   Not having an answer choice that matches your identity can be a very alienating experience.
-    
+
 
 -   ✅ Take anonymity and data security seriously. Have a plan for limiting access to this information and keeping it secure.
 
 ### Dietary Restrictions
 
 -   🍎 Ask for dietary restrictions on the registration form. Some people have severe allergies or dietary restrictions that can affect their ability to attend the conference.
-    
+
 #### Photo Policy
 
 -   🍎 If you will have a photographer at your event, include information for attendees explaining that they may be photographed and how to opt out in the registration form.
-    
+
 
 	-   (see lanyard/photography explanation under [Inclusive Practices](11_inclusive_practices_during_checkin.md))
 
@@ -186,58 +186,58 @@ What to ask on your registration form (and what not to ask)
 ✅ Offer financial support for childcare.
 
 -   Build it into your budget.
-    
-    -   Link it to sponsorships, or university partners, or make part of the registration fee from all attendees go towards providing childcare support as service.
+
+    -   Link it to sponsorships, or university partners, or make part of the registration fee from all attendees go towards providing childcare support as a service.
     -   Add an option to the registration, e.g.: "Donate $20 to help with childcare costs."
     -   Collect the data on the registration form. How many people would make use of childcare services or grants?
-    
--   In general, the two major options are either to 1) award childcare grants (people decide how to spend it, e.g. on their home babysitter) or 2) provide on-site services. 
-    
+
+-   In general, the two major options are either to 1) award childcare grants (people decide how to spend it, e.g. on their home babysitter) or 2) provide on-site services.
+
 
 ## [Inclusive Practices During Check-In](11_inclusive_practices_during_checkin.md)
 
 ### 🍎 Photography Permissions
 
 -   Managing photography opt-outs:
-    
+
 
 	-   Badge lanyard at registration should be made available to indicate photo preferences (green = photos fine; yellow = ask first; red = no photos)
-    
+
 
 ### 🍎 Pronoun Pins, Buttons, or Ribbons
 
 -   Indicating pronouns:
-    
+
 
 	-   Select a pin/button/ribbon for your lanyard to communicate your pronouns. Using a pin even if you don't feel like you need one helps create a welcoming space for attendees who do.
-    
+
 	-   Color-coordinate the pins by pronoun for quicker recognition and processing by those who see the pins. This lowers the barrier to checking (look at the color).
 
-    
+
 ## [Grants/Scholarships](08_grants_scholarships.md)
 
 ✅ Offer grants to support attendance
 
 -   Eligibility Requirements
-    
+
 
 	-   Applicants should be
-
 
-	-   from a traditionally underrepresented and/or marginalized group in the technology and/or open source communities including, but not limited to: persons identifying as LGBTQ, indigenous, women, persons of color, and/or persons with disabilities
-
+
+	-   from a traditionally underrepresented and/or marginalized group in the technology and/or open source communities including, but not limited to persons identifying as LGBTQ, indigenous, women, persons of color, and/or persons with disabilities
+
 	-   and be unable to attend without some financial assistance. (language adapted from [The Linux Foundation](https://www.linuxfoundation.org/event/api-strategy-practice-conference-2017/diversity-scholarship/))
 
 -   Payment
-    
+
 
 	-   Typically, recipients either submit receipts for reimbursement, have direct expenses paid for by the organizing committee, or are granted a lump sum up-front.
-    
+
 	-   We encourage conferences to pay for things directly rather than making attendees pay and wait to be reimbursed, or at least offer this as an option for people who want to use it.
-    
+
 
 	-   Waiting for reimbursement can be a financial burden on scholarship recipients.
-		
+
 ## [Assessment of the event](12_assessment.md)
 
  ✅ Survey participants after the event to establish whether your diversity and inclusion measures had an effect.

DISCOVER/03_organizing_committee.md

@@ -10,7 +10,7 @@ Prioritizing diversity starts with you.
 ✅ Conference chairs and lead organizers should take special care to recruit an organizing committee that reflects the diversity of the event you aspire to create.
 
 - Look for balance along many dimensions: seniority, topical expertise, geography, academia/industry, gender/racial/ethnic balance, disability status, academic lineage and many more.
-- Ensure good mix of long-term expertise and institutional memory with a flow of new people.
+- Ensure a good mix of long-term expertise and institutional memory with a flow of new people.
 - Avoid cronyism: Use algorithmic and term-limited approaches to constitute the steering committee.
 
 Offer in-person or online “unconscious bias”, harassment, and ethics training materials for steering committee members and major conference organizers.
@@ -20,7 +20,7 @@ Offer in-person or online “unconscious bias”, harassment, and ethics trainin
 
 When creating the organizing committee, be aware of the specific roles assigned to individuals. Avoid a situation in which the “housekeeping” roles are all assigned to women or other individuals from underrepresented groups. The goal is to achieve diversity across many roles, including those of high technical prestige.
 - Consider having a member of the organizing committee specifically responsible for mitigating/preventing bias and weaving inclusivity throughout the conference (e.g. "diversity chair" or co-chairs).
-- “We tried but they turned us down.” For both organizing committee and also program committee be ready with “spare” names. Since there are relatively fewer women and underrepresented minorities in the community, they are often asked to do disproportionate amounts of service, and thus are frequently forced to say no at a higher rate.
+- “We tried, but they turned us down.” For both the organizing committee and also the program committee be ready with “spare” names. Since there are relatively fewer women and underrepresented minorities in the community, they are often asked to do disproportionate amounts of service, and thus are frequently forced to say no at a higher rate.
 
 **Further Reading:**