PR#179: survey: Initial commit of new module (closes #169) - fedora-diversity

fedora-diversity

#179 survey: Initial commit of new module (closes #169)

Merged 4 years ago by jflory7. Opened 4 years ago by jflory7.

jflory7/fedora-diversity add/survey-module into master

survey: Add explicit note that survey is not actively being worked on

Justin W. Flory (he/him) • 4 years ago

6416042

survey: Initial commit of new module (closes #169)

Justin W. Flory (he/him) • 4 years ago

fb4c6e0

antora.yml

file modified

+3 -2

		`@@ -2,17 +2,18 @@`
		`# Tip: If you want to use the local preview scripts that come with this repository, please change this value in the site.yml file as well. (under site/start_page)`
		`name: diversity-inclusion`

		`- # Title will be visible on the page.`
		`+ # Title will be visible on the page.`
		`title: Diversity and Inclusion`

		`# If you don't plan to have multiple versions of the docs (for example, to document multiple versions of some software), you can ignore this field. Otherwise, change "master" to a specific version.`
		`version: master`

		`- # We encourage you to name the index page as "index.adoc". If you absolutely have to use a different name, please reflect it here. You can ignore this field otherwise.`
		`+ # We encourage you to name the index page as "index.adoc". If you absolutely have to use a different name, please reflect it here. You can ignore this field otherwise.`
		`start_page: ROOT:index`

		`# This lists all the menu definitions of your component.`
		`nav:`
		`- modules/ROOT/nav.adoc`
		`+ - modules/survey/nav.adoc`
		`- modules/events/nav.adoc`
		`- modules/outreachy/nav.adoc`

modules/ROOT/nav.adoc

file modified

-1

		`@@ -1,4 +1,3 @@`
		`- * xref:demographic-survey.adoc[Demographic survey]`
		`* xref:get-involved.adoc[Get involved]`
		`* xref:meetings.adoc[D&I Meeting Guide]`
		`* Policy`

modules/ROOT/pages/demographic-survey.adoc

file removed

-257

		`@@ -1,257 +0,0 @@`
		`- include::{partialsdir}/attributes.adoc[]`
		`-`
		`- = Demographic survey research`
		`-`
		`- This wiki page contains the draft of questions used for a Fedora contributor / demographic survey.`
		`- Most of these questions were extensively discussed and revised during the https://fedoraproject.org/wiki/FAD_Diversity_2017[FAD Diversity 2017].`
		`- More details about this can be found in Pagure ticket discussions and in Etherpads.`
		`- The questions in this wiki page are not finalized unless otherwise stated.`
		`-`
		`-`
		`- [[objectives]]`
		`- == Objectives`
		`-`
		`- The primary objectives we identified for the demographic survey were…`
		`-`
		`- 1. Gather baseline demographics about the contributor community`
		`- * Why is this objective important?`
		`- ** Better allows us to focus on groups who are underrepresented and try to improve the user experience for new contributors in the community`
		`- * Examples of target criteria:`
		`- ** Numbers for underrepresented groups (race / gender / sexuality / etc.)`
		`- ** Age of contributors`
		`- ** Gender`
		`- ** Race/Cultural background`
		`- ** Location`
		`- ** Disability`
		`- ** Family / kids / Motherhood ?`
		`- ** Non-English speaking community`
		`- 2. Determine contributor knowledge about project components that ease contribution`
		`- * Join SIG`
		`- * Mentoring Programs`
		`- * Onboarding programs`
		`- * Classrooms?`
		`- * Code of conduct / diversity and inclusion team`
		`-`
		`- [[other-comments-and-thoughts]]`
		`- === Other comments and thoughts`
		`-`
		`- Other questions, comments, and ideas from our raw notes…`
		`-`
		`- * @bee2502's musings - some questions`
		`- ** How were you introduced to Fedora?`
		`- 1. By another Fedora contributor`
		`- 2. At a Fedora event (e.g. FAD / workshop / meetup / release party)`
		`- 3. Conference`
		`- 4. Hackerspace`
		`- 5. Red Hat`
		`- 6. Web / online`
		`- ** What makes it difficult contributing to Fedora for you?`
		`-`
		`- We also wanted to identify how the data will be used and clearly communicate how the data will be used (ideally, this outline or information being available for participants in the survey to review).`
		`-`
		`-`
		`- [[relevant-resources]]`
		`- == Relevant resources`
		`-`
		`- * FLOSS Survey 2013`
		`- ** https://floss2013.larjona.net/[Questions and results]`
		`- ** http://flosshub.org/content/women-freelibreopen-source-software-situation-2010s[Women in Free/Libre/Open Source Software: The Situation in the 2010s] paper with results analysis - note how they don't conclude that they have authoritative statistics on diversity of the FLOSS community, but instead focus on comparative analysis of different groups of respondents`
		`-`
		`- * Apache Software Foundation Committer Diversity Survey`
		`- ** http://mail-archives.apache.org/mod_mbox/www-announce/201611.mbox/%3Cpony-31e1cbf2b23a01ea035ee3323fe2ab95950c8284-dc1f345f30800e5cbef086a8801c55be77bc49c3%40announce.apache.org%3E[Announcement e-mail]`
		`- ** https://cwiki.apache.org/confluence/display/COMDEV/ASF+Committer+Diversity+Survey+-+2016[Results]`
		`-`
		`-`
		`- [[survey-questions]]`
		`- == Survey questions`
		`-`
		`- Below are the "ver. 1.0" version of the survey questions.`
		`- Our last plan for these was to submit them to Fedora Legal for feedback, which I believe @bex and @marinaz were going to work on. These questions will also be updated in the {FWIKI}/Diversity/Survey[Survey wiki page].`
		`-`
		`- [[fedora-and-free-and-open-source-software-usage-and-contributions]]`
		`- === Fedora and free and open source software usage and contributions`
		`-`
		`- * How long have you been a Fedora user?`
		`- ** I have never used Fedora`
		`- ** Less than 1 year`
		`- ** 1 to 3 years`
		`- ** 3 to 6 years`
		`- ** 6 to 10 years`
		`- ** Over 10 years`
		`- ** Prefer not to say`
		`- * How long have you been a Fedora contributor?`
		`- ** I have never contributed to Fedora`
		`- ** Less than 1 year`
		`- ** 1 to 3 years`
		`- ** 3 to 6 years`
		`- ** 6 to 10 years`
		`- ** Over 10 years`
		`- ** Prefer not to say`
		`- * Please select types of contributions that you make to Fedora:`
		`- ** Community (community leadership, new contributor outreach and onboarding, diversity and inclusion work, marketing, event organization)`
		`- ** Technical (packaging, programming, infrastructure, operations, release engineering, testing / QA, language-specific SIGs)`
		`- ** Other non-technical (design, documentation, localization, translation)`
		`- ** Prefer not to say`
		`- ** Other (please specify)`
		`- * Do you contribute to Fedora as a volunteer or as an employee of a company? [select all that apply]`
		`- ** Volunteer (student)`
		`- ** Volunteer (unemployed)`
		`- ** Volunteer (retired)`
		`- ** Volunteer (outside regular job)`
		`- ** Employee (work-related contributions)`
		`- ** Prefer not to say`
		`- ** Other (please specify)`
		`- * On average, how many hours a week did you spend on Fedora contributions in the last three months?`
		`- ** 0, I have not contributed in the last three months`
		`- ** Less than 2`
		`- ** 2 - 5`
		`- ** 6 - 10`
		`- ** 11 - 20`
		`- ** 21 - 40`
		`- ** More than 40`
		`- ** Prefer not to say`
		`- * What are the top reasons you contribute to Fedora? Please check a maximum of 4 answers.`
		`- ** To participate in a global cooperative project`
		`- ** To participate in a free and open source software project`
		`- ** To improve a free and open source software project`
		`- ** Because I think that software should not be proprietary`
		`- ** To solve a problem that could not be done by proprietary software`
		`- ** To get help in realizing a good idea for a software project`
		`- ** To learn and develop new skills`
		`- ** To share my knowledge and skills`
		`- ** To improve my job opportunities`
		`- ** To get a reputation in the free and open source software scene`
		`- ** To meet other people in the free and open source software community`
		`- ** Because I enjoy working with other people in the community`
		`- ** To get funding to travel internationally`
		`- ** To earn a living`
		`- ** Prefer not to say`
		`- ** Other (please specify)`
		`- * Think of the time you made your first contribution to Fedora that was incorporated. What best describes your experience?`
		`- ** My co-worker, who was paid to work on Fedora, helped me prepare the contribution`
		`- ** A person I already knew socially helped me prepare the contribution`
		`- ** A person I did not know before helped me prepare the contribution at an in-person event`
		`- ** A person I did not know before helped me prepare the contribution via electronic communications`
		`- ** A mentor for a third-party program (e.g. Google Summer of Code, Outreachy, etc.) helped me prepare the contribution via electornic communications`
		`- ** A mentor identified by the Fedora Project helped me prepare the contribution via electronic communications`
		`- ** A person whom I identified as a mentor helped me prepare the contribution via electronic communications`
		`- ** I submitted my contribution electronically for review and it was reviewed by my co-worker, who was paid to work on Fedora`
		`- ** I submitted my contribution electronically for review and it was reviewed by someone I already knew socially`
		`- ** I submitted my contribution electronically for review and it was reviewed by someone I didn’t know before`
		`- ** Prefer not to say`
		`- ** Other (please specify)`
		`- * Do you routinely use software that is not free and open source on Fedora?`
		`- ** Yes, but only web-based applications like Google Docs`
		`- ** Yes, but only locally installed applications (including hardware drivers)`
		`- ** Yes, both web-based and locally installed applications`
		`- ** No`
		`- ** Prefer not to say`
		`- ** Other (please specify)`
		`-`
		`- [[demographics]]`
		`- === Demographics`
		`-`
		`- * What is your gender?`
		`- ** Male`
		`- ** Female`
		`- ** Non-binary`
		`- ** Prefer not to say`
		`- ** Other (please specify)`
		`- * Do you identify as lesbian, gay, bisexual, transgender or queer?`
		`- ** Yes`
		`- ** No`
		`- ** Prefer not to say`
		`- * What is your age range?`
		`- ** 17 or younger`
		`- ** 18 to 24`
		`- ** 25 to 34`
		`- ** 35 to 44`
		`- ** 45 to 54`
		`- ** 55 to 64`
		`- ** 65 to 74`
		`- ** Over 75`
		`- ** Prefer not to say`
		`- * Do you have any disability, including, but not limited to any of the ones listed https://www.dol.gov/ofccp/regs/compliance/sec503/Self_ID_Forms/VoluntarySelf-ID_CC-305_ENG_JRF_QA_508c.pdf[here]?`
		`- ** Yes`
		`- ** No`
		`- ** Prefer not to say`
		`- * Do you have a partner?`
		`- ** No, I am a single`
		`- ** Yes, although we do not live together`
		`- ** Yes, I live together with my partner`
		`- ** Yes, I am married`
		`- ** Yes, I am married, but we do not live together`
		`- ** Prefer not to say`
		`- ** Other (please specify)`
		`- * How old is your youngest child?`
		`- ** I don’t have children`
		`- ** Less than 2 years old`
		`- ** Between 2 years and 5 years old`
		`- ** Between 6 years and 10 years old`
		`- ** Between 11 years and 17 years old`
		`- ** 18 years or older`
		`- ** Prefer not to say`
		`- * What region of the world do you reside in?`
		`- ** Asia and Pacific Countries (APAC)`
		`- ** Europe and the Middle East (EMEA)`
		`- ** Latin and South America (LATAM)`
		`- ** North America (NA)`
		`- ** Prefer not to say`
		`- * What is your country of residence? [FAS Country List - Divided by Region]`
		`- * What is the highest level of education you have completed?`
		`- ** Less than secondary (High) school`
		`- ** Secondary (High) school graduate or equivalent`
		`- ** Vocational / trade program or apprenticeship`
		`- ** Some college (working towards a first level university degree)`
		`- ** Some college (not pursuing a degree anymore)`
		`- ** Associate degree`
		`- ** Bachelor’s degree`
		`- ** Master’s degree`
		`- ** Doctorate (Ph.D.) or other advanced degree (e..g M.D., J.D.)`
		`- ** Prefer not to say`
		`- ** Other (please specify)`
		`- * If you are employed, what organization do you work for?`
		`- ** I am not employed`
		`- ** Employed (please specify organization name)`
		`- ** Employed, but prefer not to specify the organization`
		`- ** Prefer not to say`
		`- * If you are employed, what do you work on? [select all that apply]`
		`- ** I am not employed`
		`- ** Software development`
		`- ** System administration`
		`- ** Testing / QA / QE`
		`- ** Technical writing`
		`- ** UX/UI design`
		`- ** Marketing /communications`
		`- ** Community and event management`
		`- ** Prefer not to say`
		`- ** Other (please specify)`
		`-`
		`- [[perception-of-experience-with-and-attitudes-towards-diversity-and-inclusion]]`
		`- === Perception of, experience with, and attitudes towards diversity and inclusion`
		`-`
		`- _Should we use headers / categories for questions, we will want something easier to read for a "production" version of this section._`
		`-`
		`- The following questions can be presented as a table, with the same set of answer options.`
		`- Questions about diverse perspectives, comfort with contributing ideas, valuing best ideas, and feeling respected were adapted from Red Hat Associate Survey.`
		`-`
		`- * Please indicate how you feel about the following statements.`
		`- ** Diverse perspectives are valued in the Fedora community.`
		`- ** I feel comfortable contributing my ideas (in meetings or online forums), even when my views differ from other contributors.`
		`- ** The people I collaborate with value the best ideas regardless of their source.`
		`- ** I feel respected when I share my ideas and opinions in the Fedora community.`
		`- ** Having greater diversity of contributors will positively impact the Fedora Project.`
		`- ** I’m appreciated for the contributions I make.`
		`- * Information about Fedora processes, policies or guidelines is easy to find.`
		`- ** Strongly agree`
		`- ** Agree`
		`- ** Slightly agree`
		`- ** Neither agree nor disagree`
		`- ** Slightly disagree`
		`- ** Disagree`
		`- ** Strongly disagree`
		`-`
		`- Please do not put any identifying information about yourself or others in either text box.`
		`-`
		`- * Is there anything you believe would improve the inclusivity of the Fedora community?`
		`- * Do you have any feedback on this survey and are there any additional questions you believe it should have asked?`

modules/events/pages/fwd-resource-pack.adoc

file modified

+4 -4

		`@@ -8,7 +8,7 @@`
		`* A summary about Fedora D&I team`
		`* Overview of different Fedora editions`
		`* Fedora and Python`
		`-`
		`+`
		`== How to welcome new contributors to Fedora?`

		`Did you come across folks who are interested in contributing to the Fedora project? Then please create link:https://pagure.io/fedora-join/Welcome-to-Fedora/issues[Welcome to Fedora ticket] for the newcomers with Fedora Join SIG. This ticket helps them to easily track their progress in the journey to becoming Fedora contributors.`
		`@@ -32,10 +32,10 @@`

		`What the D&I team works on?::`
		`The D&I team works on various tasks to support diversity and inclusion in the Fedora Project.`
		`- For example, new additions were made to the 2018 https://flocktofedora.org/[Fedora Flock conference] such as including gender-neutral bathrooms, a quiet room, and communication preference stickers.`
		`- These additions in turn supported our existing effort to draft https://pagure.io/fedora-diversity/issue/54[event inclusion guidelines] for Fedora event organizers.`
		`+ For example, new additions were made to the 2018 https://flocktofedora.org/[Fedora Flock conference] such as including gender-neutral bathrooms, a quiet room, and communication preference stickers.`
		`+ These additions in turn supported our existing effort to draft https://pagure.io/fedora-diversity/issue/54[event inclusion guidelines] for Fedora event organizers.`
		`These guidelines when shared within and outside Fedora community provide best practices to organizers holding an event.`
		`- In addition, we also hope to launch a https://pagure.io/fedora-diversity/issue/62[demographic survey] of the Fedora community in soon.`
		`+ In the past, we also worked on a xref:survey:index.adoc[Fedora Project Demographic Survey] to understand who is in the Fedora Community.`


		`== Fedora Editions`

modules/survey/nav.adoc

file added

		`@@ -0,0 +1,4 @@`
		`+ * Demographic Survey`
		`+ ** xref:index.adoc[About]`
		`+ ** xref:questions.adoc[Questions]`
		`+ ** xref:resources.adoc[Resources]`

modules/survey/pages/index.adoc

file added

+74

		`@@ -0,0 +1,74 @@`
		`+ include::ROOT:partial$attributes.adoc[]`
		`+`
		`+ = About Fedora Project Demographic Survey`
		`+ Fedora Diversity & Inclusion Team <diversity@lists.fedoraproject.org>`
		`+ :toc:`
		`+`
		`+ This section documents the Fedora Project Demographic Survey research.`
		`+ This was work completed between 2016 to 2018 to launch a demographic survey to understand the Fedora Community.`
		`+ Because of legal concerns around recent data legislation passed in this time period (https://en.wikipedia.org/wiki/General_Data_Protection_Regulation[G.D.P.R.]), the survey was planned but never published.`
		`+`
		`+ A majority of this work was completed at the https://communityblog.fedoraproject.org/fedora-diversity-fad-2017/[Fedora Diversity FAD] in January 2017.`
		`+`
		`+ [NOTE]`
		`+ ====`
		`+ This page represents six to eight months of work from the Fedora Diversity & Inclusion Team in late 2015 and early 2016.`
		`+ While the D&I Team is no longer actively working on this survey due to data collection and storage concerns (i.e. G.D.P.R.), it is retained here for historical purposes.`
		`+ The team hopes our research and work may be useful for other Open Source communities and Diversity & Inclusion programmes.`
		`+ ====`
		`+`
		`+`
		`+ [[objectives]]`
		`+ == Objectives`
		`+`
		`+ The Fedora Project Demographic Survey established these key objectives for launching such a survey:`
		`+`
		`+ [[understand]]`
		`+ === 1. Understand baseline demographics about the Fedora Community.`
		`+`
		`+ * Why this objective was important:`
		`+ Enables Fedora Diversity and Inclusion Team to identify different areas of need for contributing to Fedora, and prioritize to act on areas of most-immediate need.`
		`+ * Examples of target criteria:`
		`+ ** Age`
		`+ ** Gender`
		`+ ** Race and cultural background`
		`+ ** Geographic area or region`
		`+ ** Disability`
		`+ ** Parents and families`
		`+ ** Non-English languages`
		`+`
		`+ [[support]]`
		`+ === 2. Support underrepresented groups by supplementing on-boarding resources to other Fedora teams.`
		`+`
		`+ * Why this objective was important:`
		`+ ** Collaborate and support on-going work in other Fedora Teams by advising mentorship and teaching programs in Fedora Community`
		`+ ** Disseminate best practices through mentorship and community on-boarding`
		`+ * Examples of possible partnering teams:`
		`+ ** xref:fedora-join::index.adoc[Join SIG]`
		`+ ** Mentoring and internship programs`
		`+ (GSoC and Outreachy)`
		`+ ** xref:fedora-join::classroom/classroom.adoc[Fedora Classrooms]`
		`+`
		`+`
		`+ [[misc-comments]]`
		`+ == Miscellaneous comments`
		`+`
		`+ When the survey was first drafted in late 2016 and early 2017, several comments, ideas, and xref::resources.adoc[resources] influenced the design of the survey and an outreach campaign for it.`
		`+ Some of the pending and unresolved notes are below for archival purposes.`
		`+`
		`+ [quote,Bee Padalkar (bee2502)]`
		`+ ____`
		`+ * How were you introduced to Fedora?`
		`+ .. By another Fedora contributor`
		`+ .. At a Fedora event`
		`+ (e.g. FAD / workshop / meetup / release party)`
		`+ .. Conference`
		`+ .. Hackerspace`
		`+ .. Red Hat`
		`+ .. Web / online`
		`+ * What makes contributing to Fedora difficult for you?`
		`+ ____`
		`+`
		`+ We also wanted to identify how the data will be used.`
		`+ We aimed to make a communication plan for how the data would be used.`
		`+ Ideally, information about data use and intentions is available and embedded in the survey.`

modules/survey/pages/questions.adoc

file added

+262

		`@@ -0,0 +1,262 @@`
		`+ include::ROOT:partial$attributes.adoc[]`
		`+`
		`+ = Demographic Survey Questions`
		`+ Fedora Diversity & Inclusion Team <diversity@lists.fedoraproject.org>`
		`+ v1.0.0`
		`+ :toc:`
		`+`
		`+ This page includes the officially-approved list of questions for the Fedora Project Demographic Survey.`
		`+ It contains 23 questions.`
		`+ See the xref:index.adoc[About] and xref:resources.adoc[Resources & references] pages for additional context behind these questions.`
		`+`
		`+ [NOTE]`
		`+ ====`
		`+ This page represents six to eight months of work from the Fedora Diversity & Inclusion Team in late 2015 and early 2016.`
		`+ While the D&I Team is no longer actively working on this survey due to data collection and storage concerns (i.e. G.D.P.R.), it is retained here for historical purposes.`
		`+ The team hopes our research and work may be useful for other Open Source communities and Diversity & Inclusion programmes.`
		`+ ====`
		`+`
		`+`
		`+ [[fedora-foss]]`
		`+ == Fedora and Free and Open Source software usage and contributions`
		`+`
		`+ . How long have you been a Fedora user?`
		`+ ** I have never used Fedora`
		`+ ** Less than 1 year`
		`+ ** 1 to 3 years`
		`+ ** 3 to 6 years`
		`+ ** 6 to 10 years`
		`+ ** Over 10 years`
		`+ ** Prefer not to say`
		`+`
		`+ . How long have you been a Fedora contributor?`
		`+ ** I have never contributed to Fedora`
		`+ ** Less than 1 year`
		`+ ** 1 to 3 years`
		`+ ** 3 to 6 years`
		`+ ** 6 to 10 years`
		`+ ** Over 10 years`
		`+ ** Prefer not to say`
		`+`
		`+ . Please select types of contributions that you make to Fedora:`
		`+ ** Community`
		`+ (community leadership, new contributor outreach and onboarding, diversity and inclusion work, marketing, event organization)`
		`+ ** Technical`
		`+ (packaging, programming, infrastructure, operations, release engineering, testing / QA, language-specific SIGs)`
		`+ ** Other non-technical`
		`+ (design, documentation, localization, translation)`
		`+ ** Prefer not to say`
		`+ ** Other`
		`+ (please specify)`
		`+`
		`+ . Do you contribute to Fedora as a volunteer or as an employee of a company?`
		`+ [select all that apply]`
		`+ ** Volunteer`
		`+ (student)`
		`+ ** Volunteer`
		`+ (unemployed)`
		`+ ** Volunteer`
		`+ (retired)`
		`+ ** Volunteer`
		`+ (outside regular job)`
		`+ ** Employee`
		`+ (work-related contributions)`
		`+ ** Prefer not to say`
		`+ ** Other`
		`+ (please specify)`
		`+`
		`+ . On average, how many hours a week did you spend on Fedora contributions in the last three months?`
		`+ ** 0, I have not contributed in the last three months`
		`+ ** Less than 2`
		`+ ** 2 - 5`
		`+ ** 6 - 10`
		`+ ** 11 - 20`
		`+ ** 21 - 40`
		`+ ** More than 40`
		`+ ** Prefer not to say`
		`+`
		`+ . What are the top reasons you contribute to Fedora?`
		`+ Please check a maximum of 4 answers.`
		`+ ** To participate in a global cooperative project`
		`+ ** To participate in a free and open source software project`
		`+ ** To improve a free and open source software project`
		`+ ** Because I think that software should not be proprietary`
		`+ ** To solve a problem that could not be done by proprietary software`
		`+ ** To get help in realizing a good idea for a software project`
		`+ ** To learn and develop new skills`
		`+ ** To share my knowledge and skills`
		`+ ** To improve my job opportunities`
		`+ ** To get a reputation in the free and open source software scene`
		`+ ** To meet other people in the free and open source software community`
		`+ ** Because I enjoy working with other people in the community`
		`+ ** To get funding to travel internationally`
		`+ ** To earn a living`
		`+ ** Prefer not to say`
		`+ ** Other`
		`+ (please specify)`
		`+`
		`+ . Think of the time you made your first contribution to Fedora that was incorporated. What best describes your experience?`
		`+ ** My co-worker, who was paid to work on Fedora, helped me prepare the contribution`
		`+ ** A person I already knew socially helped me prepare the contribution`
		`+ ** A person I did not know before helped me prepare the contribution at an in-person event`
		`+ ** A person I did not know before helped me prepare the contribution via electronic communications`
		`+ ** A mentor for a third-party program (e.g. Google Summer of Code, Outreachy, etc.) helped me prepare the contribution via electornic communications`
		`+ ** A mentor identified by the Fedora Project helped me prepare the contribution via electronic communications`
		`+ ** A person whom I identified as a mentor helped me prepare the contribution via electronic communications`
		`+ ** I submitted my contribution electronically for review and it was reviewed by my co-worker, who was paid to work on Fedora`
		`+ ** I submitted my contribution electronically for review and it was reviewed by someone I already knew socially`
		`+ ** I submitted my contribution electronically for review and it was reviewed by someone I didn’t know before`
		`+ ** Prefer not to say`
		`+ ** Other`
		`+ (please specify)`
		`+`
		`+ . Do you routinely use software that is not free and open source on Fedora?`
		`+ ** Yes, but only web-based applications like Google Docs`
		`+ ** Yes, but only locally installed applications (including hardware drivers)`
		`+ ** Yes, both web-based and locally installed applications`
		`+ ** No`
		`+ ** Prefer not to say`
		`+ ** Other`
		`+ (please specify)`
		`+`
		`+`
		`+ [[demographics]]`
		`+ == Demographics`
		`+`
		`+ . What is your gender?`
		`+ ** Male`
		`+ ** Female`
		`+ ** Non-binary`
		`+ ** Prefer not to say`
		`+ ** Other`
		`+ (please specify)`
		`+`
		`+ . Do you identify as lesbian, gay, bisexual, transgender or queer?`
		`+ ** Yes`
		`+ ** No`
		`+ ** Prefer not to say`
		`+`
		`+ . What is your age range?`
		`+ ** 17 or younger`
		`+ ** 18 to 24`
		`+ ** 25 to 34`
		`+ ** 35 to 44`
		`+ ** 45 to 54`
		`+ ** 55 to 64`
		`+ ** 65 to 74`
		`+ ** Over 75`
		`+ ** Prefer not to say`
		`+`
		`+ . Do you have any disability, including, but not limited to any of the ones listed https://www.dol.gov/ofccp/regs/compliance/sec503/Self_ID_Forms/VoluntarySelf-ID_CC-305_ENG_JRF_QA_508c.pdf[here]?`
		`+ ** Yes`
		`+ ** No`
		`+ ** Prefer not to say`
		`+`
		`+ . Do you have a partner?`
		`+ ** No, I am a single`
		`+ ** Yes, although we do not live together`
		`+ ** Yes, I live together with my partner`
		`+ ** Yes, I am married`
		`+ ** Yes, I am married, but we do not live together`
		`+ ** Prefer not to say`
		`+ ** Other`
		`+ (please specify)`
		`+`
		`+ . How old is your youngest child?`
		`+ ** I don’t have children`
		`+ ** Less than 2 years old`
		`+ ** Between 2 years and 5 years old`
		`+ ** Between 6 years and 10 years old`
		`+ ** Between 11 years and 17 years old`
		`+ ** 18 years or older`
		`+ ** Prefer not to say`
		`+`
		`+ . What region of the world do you reside in?`
		`+ ** Asia and Pacific Countries`
		`+ (APAC)`
		`+ ** Europe and the Middle East`
		`+ (EMEA)`
		`+ ** Latin and South America`
		`+ (LATAM)`
		`+ ** North America`
		`+ (NA)`
		`+ ** Prefer not to say`
		`+`
		`+ . What is your country of residence?`
		`+ [FAS Country List - Divided by Region]`
		`+`
		`+ . What is the highest level of education you have completed?`
		`+ ** Less than secondary (High) school`
		`+ ** Secondary (High) school graduate or equivalent`
		`+ ** Vocational / trade program or apprenticeship`
		`+ ** Some college`
		`+ (working towards a first level university degree)`
		`+ ** Some college`
		`+ (not pursuing a degree anymore)`
		`+ ** Associate degree`
		`+ ** Bachelor’s degree`
		`+ ** Master’s degree`
		`+ ** Doctorate (Ph.D.) or other advanced degree`
		`+ (e.g. M.D., J.D.)`
		`+ ** Prefer not to say`
		`+ ** Other`
		`+ (please specify)`
		`+`
		`+ . If you are employed, what organization do you work for?`
		`+ ** I am not employed`
		`+ ** Employed`
		`+ (please specify organization name)`
		`+ ** Employed, but prefer not to specify the organization`
		`+ ** Prefer not to say`
		`+`
		`+ . If you are employed, what do you work on?`
		`+ [select all that apply]`
		`+ ** I am not employed`
		`+ ** Software development`
		`+ ** System administration`
		`+ ** Testing / QA / QE`
		`+ ** Technical writing`
		`+ ** UX/UI design`
		`+ ** Marketing /communications`
		`+ ** Community and event management`
		`+ ** Prefer not to say`
		`+ ** Other`
		`+ (please specify)`
		`+`
		`+`
		`+ [[perception]]`
		`+ == Perception of, experience with, and attitudes towards diversity and inclusion`
		`+`
		`+ [NOTE]`
		`+ ====`
		`+ This section title may need revisions for simplicity.`
		`+ ====`
		`+`
		`+ The following questions can be presented as a table, with the same set of answer options.`
		`+ Questions about diverse perspectives, comfort with contributing ideas, valuing best ideas, and feeling respected were adapted from Red Hat Associate Survey.`
		`+`
		`+ . Please indicate how you feel about the following statements.`
		`+ ** Diverse perspectives are valued in the Fedora community.`
		`+ ** I feel comfortable contributing my ideas (in meetings or online forums), even when my views differ from other contributors.`
		`+ ** The people I collaborate with value the best ideas regardless of their source.`
		`+ ** I feel respected when I share my ideas and opinions in the Fedora community.`
		`+ ** Having greater diversity of contributors will positively impact the Fedora Project.`
		`+ ** I’m appreciated for the contributions I make.`
		`+`
		`+ . Information about Fedora processes, policies or guidelines is easy to find.`
		`+ ** Strongly agree`
		`+ ** Agree`
		`+ ** Slightly agree`
		`+ ** Neither agree nor disagree`
		`+ ** Slightly disagree`
		`+ ** Disagree`
		`+ ** Strongly disagree`
		`+`
		`+ [NOTE]`
		`+ ====`
		`+ For the final two questions, do not add personally-identifying information about yourself or others in either text box.`
		`+ ====`
		`+`
		`+ . Is there anything you believe would improve the inclusivity of the Fedora community?`
		`+`
		`+ . Do you have any feedback on this survey and are there any additional questions you believe it should have asked?`

modules/survey/pages/resources.adoc

file added

+18

		`@@ -0,0 +1,18 @@`
		`+ include::ROOT:partial$attributes.adoc[]`
		`+`
		`+ = Resources & references`
		`+`
		`+ Several other existing surveys, Open Source research studies, and other writing influenced the creation, design, and execution of this survey:`
		`+`
		`+ [NOTE]`
		`+ ====`
		`+ FLOSS Survey 2013 focuses on a comparative analysis of different groups of respondents instead of asserting authoritative statistics abour diversity in the Open Source community.`
		`+ ====`
		`+`
		`+ FLOSS Survey 2013::`
		`+ * https://floss2013.larjona.net/[Questions and results]`
		`+ * http://flosshub.org/content/women-freelibreopen-source-software-situation-2010s[Women in Free/Libre/Open Source Software: The Situation in the 2010s] paper with results analysis`
		`+`
		`+ Apache Software Foundation Committer Diversity Survey::`
		`+ * http://mail-archives.apache.org/mod_mbox/www-announce/201611.mbox/%3Cpony-31e1cbf2b23a01ea035ee3323fe2ab95950c8284-dc1f345f30800e5cbef086a8801c55be77bc49c3%40announce.apache.org%3E[Announcement e-mail]`
		`+ * https://cwiki.apache.org/confluence/display/COMDEV/ASF+Committer+Diversity+Survey+-+2016[Results]`

jflory7 commented 4 years ago

This commit makes the following changes:

Creates a new Antora module (survey) to better organize the research, work, and questions from the Fedora Project Demographic Survey
Removes "Demographic survey" page from ROOT module, removes from ROOT module nav.adoc
Adds survey module nav.adoc into the main Antora site configuration

Closes #169.

jflory7 commented 4 years ago

rebased onto fb4c6e0

4 years ago

jflory7 commented 4 years ago

Metadata Update from @jflory7:
- Pull-request tagged with: needs feedback, new change, type - docs

4 years ago

jflory7 commented 4 years ago

@ramyaparimi @lilyx If both of you have a moment, could you please take a look at this Pull Request and leave your feedback (+1 or -1 with comment) before it is merged?

@bee2502 @jonatoni @amsharma @tatica If you all have a moment, your feedback is also welcome since you were here when we put together the first survey draft.

ramyaparimi commented 4 years ago

@jflory7 +1
This LGTM :thumbsup:

lilyx commented 4 years ago

@jflory7 +1

I was just curious about the questions regarding country and regions of residence around lines 160ish.
If we are asking for country of residence, is the question on region of residence necessary? particularly given the size of the regions specified. Would it be more beneficial to ask for country of residence and then country of origin, our just leave it at country of residence and then group the data into relevant regions for analysis later?

Not a huge deal, it looks great all around, just thought that this stood out as an odd redundancy.

1 new commit added

survey: Add explicit note that survey is not actively being worked on

4 years ago

jflory7 commented 4 years ago

@ramyaparimi @lilyx Thanks for reviewing and leaving feedback!

From the D&I Team meeting today, I pushed commit 6416042 with explicit clarification that the survey is no longer being actively worked on.

@lilyx The country/region of residence redundancy is a good catch. At the time we wrote these questions, we were considering this way because there are a few countries that Fedora cannot ask about or does not recognize because Red Hat's legal jurisdiction does not recognize them, e.g. Iran, Kosovo. The region question was a way for us to work around this sticky legal barrier with U.S. trade embargoes and sanctions. You would never believe it was so hard to just ask someone where they are from!

I agree it is in redundant in practice, and maybe we don't actually want to ask for country of residence after all. But for now, I will keep it there to reflect historical accuracy of our conversations back in 2015/2016.

I'm going to go ahead and merge this through. Thanks again both for reviewing :tada:

Pull-Request has been merged by jflory7

4 years ago

Metadata Update from @jflory7:
- Pull-request untagged with: needs feedback
- Request assigned

4 years ago