PR#181: Restructure D&I landing page - fedora-diversity

		`@@ -2,16 +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/ROOT/pages/index.adoc

file modified

+51 -41

		`@@ -3,76 +3,86 @@`
		`= Diversity and inclusion in Fedora`
		`:toc:`

		`- The Fedora Project welcomes and encourages participation by everyone.`
		`- Our community is based on mutual respect, tolerance, and encouragement, and we work to help each other live up to these principles.`
		`- Please, refer to our xref:project:ROOT:code-of-conduct.adoc[Code of Conduct] for more information.`
		`- The Fedora Diversity and Inclusion team (Fedora D&I team) is committed to fostering diversity and inclusion in the Fedora community.`
		`+ The goal of our team is to encourage diversity and inclusion in the Fedora community.By inclusion, we mean to create a comfortable environment to encourage and empower everyone to be part of the community.`
		`+ Inclusion is not about just being respectful to each other anymore!`
		`+ It is to make the community accessible to groups from underpresented, disabled and many other communities.`
		`+ While the Fedora Project is open to contributions from everyone, our community stands strong on pillars of mutual respect, tolerance and encouragement.`
		`+ Please checkout our xref:project:ROOT:code-of-conduct.adoc[code of conduct] for more information.`

		`- You can watch our recent video showcasing the Fedora community https://www.youtube.com/watch?v=O1eHRoEps6I[here].`
		`+ To get a sneak peak of the Fedora community, check out https://www.youtube.com/watch?v=O1eHRoEps6I[Flock to Fedora-2019] that happened at Budapest!`

		`image::infographic-2020.png[Infographic with statistics about Fedora Women's Day since 2016. Created by Smera Goel.]`

		`-`
		`[[goals]]`
		`== Goals`

		`- The goal of this initiative is to help foster diversity and inclusion in the Fedora community.`
		`- The Fedora D&I team works towards this goal by focusing on efforts including (but not limited to):`
		`-`
		`- * Creating content and organizing events to spread awareness about diversity within Fedora and outside the Fedora community.`
		`- * Supporting community building and engagement activities to foster inclusion.`
		`- * Coordinating with Fedora SIGs and subprojects to futher foster diversity and inclusion in the community.`
		`- * Supporting programs committed to building diversity and inclusion in Free and Open Source Software communities.`
		`+ The Fedora D&I team strives to enhance diversity and inclusion by focusing on some of the efforts mentioned below:`

		`- https://fedoraprojectpodcast.simplecast.com/episodes/fedora-diversity-inclusion-team[Fedora Podcast] gives further insight into the purpose, objective and working process of the team in a huge community project.`
		`- The podcast has interesting conversations between the members of D&I team and Eduard Lucena (@x3mboy).`
		`+ * Organize events to bring awareness about diversity both within and outside the Fedora community.`
		`+ * Cultivate inclusion by organizing community building and engagement activities.`
		`+ * Enrich diversity and inclusion within Fedora by co-ordinating with other Fedora SIGs and sub-projects.`
		`+ * Support events and programs that promote diversity and inclusion in Free and Open Source Software communities`

		`+ https://fedoraprojectpodcast.simplecast.com/episodes/fedora-diversity-inclusion-team[Fedora Podcast] gives further insight into the purpose, objective and working process of the team.`
		`+ The podcast has interesting conversation between members of the D&I team and Eduard Lucena (@x3mboy).`

		`[[current-projects]]`
		`== Current Projects`

		`- We are tracking our ongoing work and action items https://pagure.io/fedora-diversity/issues[here] in Pagure.`
		`+ We track our https://pagure.io/fedora-diversity/issues[ongoing work and action items] in Pagure.`

		`[[fedora-women]]`
		`=== Fedora Women`

		`- Fedora Women aims to foster involvement of women (cis and trans) and genderqueer people in Fedora and Free and Open Source Software.`
		`+ The https://fedoraproject.org/wiki/Women[Fedora Women] team is no longer active or maintained. However, as the goal of Fedora Women and Fedora D&I team align with each other, the D&I team has taken up to organize Fedora Women's Day event, that aims to keep the goal of Fedora Women alive!`
		`+`
		`+ Fedora Women aims to nurture the involvement of women (cis and trans) and genderqueer people in Fedora and other Free and Open Source Software projects.`
		`+ In addition, this community aims to bring awareness of contributions by women/non-binary in the Fedora Project.`
		`+ Regardless of one's gender, Fedora Women welcomes anyone who supports women's involvement in Fedora.`

		`+ Join Fedora Women community at IRC Freenode on https://webchat.freenode.net/#fedora-women[#fedora-women] channel.`
		`+ Subscribe to the https://lists.fedoraproject.org/admin/lists/women.lists.fedoraproject.org/[Fedora Women mailing list] for latest updates.`

		`[[events]]`
		`=== Events`

		`- Fedora Diversity and Inclusion team organizes and supports a variety of xref:events:index.adoc[events] with the aim of fostering diversity and inclusion in Fedora community.`
		`- Our key focuses are to engage, empower, and celebrate the contributions of women, LGBT+, BIPOC, and people with disabilities in open source projects and communities.`
		`- If you are interested in working with us to organize events in your local community, send us an email. We are always looking for new collaborators.`
		`+ xref:events:index.adoc[Events] organized by the Fedora D&I team focus to:`
		`+`
		`+ * Celebrate the contributions of women, LGBT+, BIPOC, and people with disabilities and`
		`+ * Engage, empower and encourage diverse folks in the open source communities.`
		`+`
		`+ If you are interested in organizing such event at your locality, please send us an email. We are always looking for new collaborators.`
		`+ In addition, please checkout the xref:events:fwd-resource-pack.adoc[Event Resource Pack] for more information.`

		`+ [[demographic-survey]]`
		`+ == Demographic Survery`

		`- [[meetings]]`
		`- == Meetings`
		`+ The xref:survery:index.adoc[Demographic Survery] was launched to understand demographics of the Fedora Community.`

		`- The Diversity and Inclusion team generally meets bi-weekly in #fedora-diversity at 14:00 UTC on Thursdays.`
		`- Calendar information about our upcoming meetings can be found at: https://apps.fedoraproject.org/calendar/meeting/9784/[here].`
		`- Meeting logs are available at https://meetbot.fedoraproject.org/sresults/?group_id=fedora-diversity&type=channel[Meetbot]`
		`+ 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 for historical purposes.`
		`+ The team hopes our research and work may be useful for other Open Source communities and Diversity & Inclusion programmes.`

		`+ [[get-involved-with-us]]`
		`+ == Get Involed With Us`
		`+`
		`+ * Are you willing to help us with enhancing diversity and inclusion Fedora community?`
		`+ * Are you part of a local hackerspace, Linux User Group(LUG) or STEM community?`
		`+ * Are you involved in open source project beyond Fedora?`

		`- [[get-in-touch]]`
		`- == Get in touch with us`
		`+ If you said YES to one or more points above,then you are at the right place!`
		`+ Our team always looks forward to working with folks from diverse backgrounds.`
		`+ We believe everyone can bring value to our goal in one way or the other.`

		`- Are you an individual contributor who wants to help us shape diversity and inclusion in the Fedora community?`
		`- Are you a part of a local hackerspace, LUG or STEM community?`
		`- Are you involved in open source project beyond Fedora?`
		`- Did you say YES to any one of these?`
		`- Diversity efforts require that we work with all parts of Fedora.`
		`- We feel that everyone can bring in valuable inputs to this conversation.`
		`- We have diverse and flexible contribution opportunities available for everyone.`
		`+ If you are interested in working with us, please checkout how to xref:get-involved.adoc[get involved with us] to start your journey with our team!`

		`- * If you'd like to help out, please introduce yourself on our {MAILINGLIST}[Diversity & Inclusion mailing list].`
		`+ [[meeting-guide]]`
		`+ === Meeting Guide`

		`- * You can join the conversation via IRC #fedora-diversity on Freenode.`
		`- We also have a Telegram bridge to IRC https://t.me/fedoradiversity[here].`
		`+ xref:meetings.adoc[Meetings] of the D&I team are held every other Thursday in https://webchat.freenode.net/?channels=#fedora-diversity[#fedora-diversity] channel at 14:00 UTC.`
		`+ If you are interested in attending or chairing our meetings, checkout our xref:meetings.adoc[meeting guide] for information.`

		`- * We are especially looking for other open source projects and local communities to share resources and collaborate together.`
		`- Please get in touch via the above mentioned ways or open a new ticket https://pagure.io/fedora-diversity/issues[here].`
		`+ [[Policy]]`
		`+ == Policy`

		`- * Feel like you don't have much time to contribute?`
		`- Subscribe to our {MAILINGLIST}[Diversity & Inclusion mailing list] to receive updates about our work.`
		`+ We follow lazy approval method!`
		`+ Checkout xref:decision-process.adoc[policy page] to know more about our decision making process.`

modules/events/nav.adoc

file modified

+9 -2

		`@@ -1,3 +1,10 @@`
		`* xref:index.adoc[D&I Events]`
		`- ** xref:about-fwd.adoc[Fedora Women's Day]`
		`- *** xref:fwd-resource-pack.adoc[Resource pack]`
		`+ ** xref:flock-social-events.adoc[Flock Social Events]`
		`+ ** Fedora Women's Day`
		`+ *** xref:fwd/about-fwd.adoc[About]`
		`+ *** xref:fwd/history.adoc[History]`
		`+ *** xref:fwd/organize.adoc[How to organize]`
		`+ *** xref:fwd/participate.adoc[How to participate]`
		`+ ** xref:past-events.adoc[Past Events]`
		`+ ** xref:fwd-resource-pack.adoc[Resource pack]`
		`+`

modules/events/pages/flock-social-events.adoc

file added

		`@@ -0,0 +1,7 @@`
		`+ [INFO]`
		`+ ====`
		`+ This page is still a placeholder.`
		`+ It is not yet written!`
		`+`
		`+ If you want to help write it, review the https://pagure.io/fedora-diversity/issues[Fedora D&I Pagure issue tracker] to see where you can get involved.`
		`+ ====`
		`\ No newline at end of file`

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

file modified

+5 -5

		`@@ -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.`
		`@@ -20,7 +20,7 @@`

		`At your event, start with an introduction to the Fedora Diversity and Inclusion Team.`
		`Explain the role of D&I team in the Fedora community and its upcoming goals.`
		`- Share our xref:diversity-inclusion::team.adoc[team's introduction page] with anyone who is interested in learing more.`
		`+ Share our xref:ROOT:index.adoc[team's introduction page] with anyone who is interested in learing more.`

		`What is the role of Fedora Diversity and Inclusion Team?::`
		`As the name indicates, the main goal of the D&I team is to foster diversity and inclusion in Fedora community.`
		`@@ -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/events/pages/fwd/about-fwd.adoc ~~modules/events/pages/about-fwd.adoc~~

file renamed

file was moved with no change to the file

modules/events/pages/fwd/history.adoc

file added

		`@@ -0,0 +1,7 @@`
		`+ [INFO]`
		`+ ====`
		`+ This page is still a placeholder.`
		`+ It is not yet written!`
		`+`
		`+ If you want to help write it, review the https://pagure.io/fedora-diversity/issues[Fedora D&I Pagure issue tracker] to see where you can get involved.`
		`+ ====`
		`\ No newline at end of file`

modules/events/pages/fwd/organize.adoc

file added

		`@@ -0,0 +1,7 @@`
		`+ [INFO]`
		`+ ====`
		`+ This page is still a placeholder.`
		`+ It is not yet written!`
		`+`
		`+ If you want to help write it, review the https://pagure.io/fedora-diversity/issues[Fedora D&I Pagure issue tracker] to see where you can get involved.`
		`+ ====`
		`\ No newline at end of file`

modules/events/pages/fwd/participate.adoc

file added

		`@@ -0,0 +1,7 @@`
		`+ [INFO]`
		`+ ====`
		`+ This page is still a placeholder.`
		`+ It is not yet written!`
		`+`
		`+ If you want to help write it, review the https://pagure.io/fedora-diversity/issues[Fedora D&I Pagure issue tracker] to see where you can get involved.`
		`+ ====`
		`\ No newline at end of file`

modules/events/pages/past-events.adoc

file added

		`@@ -0,0 +1,7 @@`
		`+ [INFO]`
		`+ ====`
		`+ This page is still a placeholder.`
		`+ It is not yet written!`
		`+`
		`+ If you want to help write it, review the https://pagure.io/fedora-diversity/issues[Fedora D&I Pagure issue tracker] to see where you can get involved.`
		`+ ====`
		`\ No newline at end of file`

modules/outreachy/nav.adoc

file added

		`@@ -0,0 +1,1 @@`
		`+ * xref:about.adoc[Outreachy]`
		`\ No newline at end of file`

modules/outreachy/pages/about.adoc

file added

		`@@ -0,0 +1,7 @@`
		`+ [INFO]`
		`+ ====`
		`+ This page is still a placeholder.`
		`+ It is not yet written!`
		`+`
		`+ If you want to help write it, review the https://pagure.io/fedora-diversity/issues[Fedora D&I Pagure issue tracker] to see where you can get involved.`
		`+ ====`
		`\ No newline at end of file`

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]`

ramyaparimi commented 3 years ago

This PR is for issue #166 to restructure the D&I team landing page.

This includes some additional information about Fedora Women, Demographic Survey and couple other changes for easy flow of the landing page.
It also includes links to the appropriate pages for better navigation.

1 new commit added

minor grammar edit

3 years ago

1 new commit added

minor sentence changes

3 years ago

ramyaparimi commented 3 years ago

@jflory7 Could you please let me know your thoughts on the changes I made? :grinning:

Edited 3 years ago by ramyaparimi

rebased onto a2eab22

3 years ago

Metadata Update from @jflory7:
- Pull-request tagged with: improvement, needs feedback, type - docs
- Request assigned

3 years ago

jflory7 commented on line 10 of modules/ROOT/pages/index.adoc 3 years ago

Minor nitpick, but there are two sentences on this line. Can split out to two lines. :)

jflory7 commented on line 28 of modules/ROOT/pages/index.adoc 3 years ago

s/focussing/focusing/
s/some of the many/the/

jflory7 commented on line 50 of modules/ROOT/pages/index.adoc 3 years ago

This line might take some word-smithing. While the Fedora Women community long precedes the D&I Team, it is no longer active or maintained. I think the Fedora Women initiative naturally "fell" to us once the team launched, but I'm not sure if we have done much to keep it up and runnig, with the exception perhaps of Fedora Women's Day events.

jflory7 commented on line 65 of modules/ROOT/pages/index.adoc 3 years ago

My preference is not to include articles (the, a, an) in hyperlinks. Search engines pick up on the text you use for hyperlinks, so I usually prefer to omit articles since they don't add much for Search Engine Optimization (S.E.O.).

jflory7 commented on line 78 of modules/ROOT/pages/index.adoc 3 years ago

I think this xref will break now that #179 is merged.

jflory7 commented on line 90 of modules/ROOT/pages/index.adoc 3 years ago

Maybe we should expand the LUG acronym since it is not obvious like it was 20 years ago. LUG == Linux User Group.

jflory7 commented on line 91 of modules/ROOT/pages/index.adoc 3 years ago

s/nvolved/involved/

jflory7 commented on line 96 of modules/ROOT/pages/index.adoc 3 years ago

Lines 95 and 96 can go together on one line. We don't need to split new lines by commas. :)

jflory7 commented on line 107 of modules/ROOT/pages/index.adoc 3 years ago

s/get-involced.adoc/get-involved.adoc/

jflory7 commented on line 115 of modules/ROOT/pages/index.adoc 3 years ago

s/Thurday/Thursday/

Looking at this… I almost wonder if we should add new attributes, e.g. {MEETING-DAY} and {MEETING-TIME}, and then we can use those attributes on several different pages while only requiring an update to it in a single place. Historically, we sometimes forget to update our docs when our meeting day/time changes!

Might not be in scope for this PR if you do not have time to tweak it. But it would be more convenient this way.

jflory7 commented on line 125 of modules/ROOT/pages/index.adoc 3 years ago

Split to two lines after exclamation point.

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

3 years ago

jflory7 commented 3 years ago

Hi @ramyaparimi, this PR looks good! I had specific feedback that I left in-line for you to review. Once the feedback is addressed, we can merge this and close out #166.

Also curious what others (@jonatoni, @amsharma, @riecatnor, @nasirhm, @orionstar25, @lilyx) think of this update and if it is what they all expect too.

ramyaparimi commented 3 years ago

@jflory7 Thank you very much for taking your time to look at it :grinning:

rebased onto 46bbdff

3 years ago

1 new commit added

tried to fix xref links

3 years ago

ramyaparimi commented on line 79 of modules/ROOT/pages/index.adoc 3 years ago

In my local preview the xref link to demographic questions was not working. I am not sure what I am doing wrong.

ramyaparimi commented on line 126 of modules/ROOT/pages/index.adoc 3 years ago

Same with policy page xref as well! Not sure why it is not working.

ramyaparimi commented 3 years ago

Hello everyone! I made the changes suggested and tried to fix xref links. Couple of them are not working. Not sure why. Please let me know what I am doing wrong.
Thank you!

meskarune commented 3 years ago

It would be really nice to see more specifics on what sort of diversity you are focusing on and what "inclusive" means.

Like is the focus on a diversity of life experience or under represented groups in free software or historically marginalized groups?

To me, being inclusive means everyone feels comfortable and empowered to participate and contribute. This means not only a respectful community but also one that is accessible for the disabled, has multiple avenues for communication to account for different styles and has people's privacy and safety a high priority. If Fedora has any pages on a user privacy policy that should be linked.

Maybe you can state the problem you are trying to address with the goals too. Something like,

"The Fedora community stands on strong pillars of mutual respect, tolerance and encouragement, however this is not enough to increase the participation of socially marginalized groups in the Fedora community. To do this, Fedora is taking an active role to encourage more diverse participation by..."

A lot of people don't understand the purpose of diversity initiatives because they think just being kind to others is good enough. I think a tiny bit of explaination can help with getting people to understand why having education and active involvement is important.

If possible maybe we could get some newbie people to have a look here and see if their questions get answered.

orionstar25 commented 3 years ago

In my local preview the xref link to demographic questions was not working. I am not sure what I am doing wrong. xref:survery:index.adoc[Demographic Survery]

I am not a 100% positive but you are trying to access modules/survey/pages/index.adoc from module/root/pages/index.adoc. Hence you need to specify the correct relative path so that the file can be found.
https://docs.antora.org/antora/2.2/asciidoc/page-to-page-xref/#different-module

Similar for policy link.

orionstar25 commented 3 years ago

W.r.t to the structuring of the landing page, I seem content with this approach. With all bugs fixed, I think this is fairly organized. Good work on the easy flow of topics @ramyaparimi!

If we talk about the relevant content improvement that needs to go here, I'd rather have that discussion abstracted out in another ticket. This ticket serves as a good baseline for restructuring and further creativity.
I am however of the opinion that the landing page should be crisp and ready to route people to relevant (and maybe more important) links. Having too much explanation/content on the landing page itself can get overwhelming.

But, I feel that we can add @meskarune 's well explanatory suggestions along with the introduction text (right before the infographic). It will set the correct tone for the entire docs. :thumbsup:

lilyx commented on line 55 of modules/ROOT/pages/index.adoc 3 years ago

grammar edit needed: "anyone who supports women's involvement in Fedora"

Edited 3 years ago by lilyx

1 new commit added

minor changes to address the feedback

3 years ago

ramyaparimi commented 3 years ago

Thank you @orionstar25 @meskarune @lilyx for the feedback!!

I added a couple of lines to address @meskarune feedback. I tried to get the idea and also tried to keep it short. Let me know your thoughts!

I agree that the landing page now can be a good foundation and there is always room for creativity to add more information. May be creating other pages with additional information that can be xrefed and placed in nav bar could be an idea? So folks interested in getting more information can go ahead without getting to too much information in the landing page.

Edited 3 years ago by ramyaparimi

jflory7 commented 3 years ago

Thanks @meskarune for the thoughtful feedback. I opened issue #183 to track your feedback, because I think that can actually be tied into something much bigger for the team. :grinning:

From my point-of-view, the content in this Pull Request is ready to go. There are 12 commits in this PR though; it would be nice to squash them down into a single commit so the git commit log remains easy to read and legible. I'll follow up in DM about squashing a PR down to one commit. :)

Any other final feedback before we merge? Thanks all for taking a look!

Metadata Update from @jflory7:
- Pull-request untagged with: needs changes

3 years ago

10 new commits added