From 3216541f917be152b2c6b576796264474e35cd7f Mon Sep 17 00:00:00 2001 From: Graham White Date: Jun 08 2022 20:19:32 +0000 Subject: [PATCH 1/2] Restructure the front page to flow more logically and better describe the team(s) --- diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc index 2fb883a..3fe4f36 100644 --- a/docs/modules/ROOT/pages/index.adoc +++ b/docs/modules/ROOT/pages/index.adoc @@ -1,52 +1,39 @@ include::ROOT:partial$attributes.adoc[] -= Fedora Websites & Apps += Fedora Websites & Apps Team -Welcome to the official documentation for the Fedora Websites & Apps Team. +Welcome to the official documentation for the Fedora Websites & Apps Team. The team was rebooted in 2021 as a part of the https://fedoraproject.org/wiki/Objectives/Websites_%26_Apps_Community_Revamp[Websites & Apps Community Revamp Objective]. With the onset of this council objective, the team has been growing ever since with developers, designers and project managers having a wide range of skills and interests all members of the team and contributing to the Fedora Websites and Apps. [[about]] -== About our team +== About the team -Our websites being our representation to the wider community of users and contributors over the internet, the team works on designing, developing and maintaining these user-friendly interfaces. The community-led team consists of voluntary contributors from around the world and are involved loosely in the following activities. +Our websites are of top priority and imporance, being our web-based representation to the wider community of users and contributors. The team works on designing, developing and maintaining user-friendly interfaces. The community-led team consists of voluntary contributors from around the world that are involved in activities such as the following: -=== Consolidate key Fedora Project websites into a single uniform scheme -In terms of design (look/feel and UI/UX), engineering (tech stack and implementation) and operation (navigation and content), the team attempts to maintain the websites as consistently as possible. +* Consolidate key Fedora Project websites into a single uniform scheme: in terms of design (look/feel and UI/UX), engineering (tech stack and implementation) and operation (navigation and content), the team attempts to maintain the websites as consistently as possible. -=== Develop frontend and backend components of Fedora's web applications -With the use of frontend tools (HTML, CSS, JavaScript and the related frameworks) and backend tools (Python, Ansible, JavaScript and the related frameworks), the team develops the web applications. +* Develop frontend and backend components of Fedora's web applications: with the use of frontend tools (HTML, CSS, JavaScript and the related frameworks) and backend tools (Python, Ansible, JavaScript and the related frameworks), the team develops and maintainers the web applications. -=== Making websites as fun and exciting as the project they represent -A book might not be judged by its cover but a project is likely to be judged by the website it is represented by. The team ensures that the websites precisely represent the project's details and offerings. +* Making websites as fun and exciting as the project they represent: a book might not be judged by its cover but a project is likely to be judged by the website it is represented by. The team ensures that the websites precisely represent the project's details and offerings. -=== Help maintain content that doesn't fall under any particular subproject -The team works on maintaining the content on certain online elements are very generic in nature, like documentation, community wiki, event banners which do not fit in a certain subteam or SIG. +* Help maintain content that doesn't fall under any particular subproject: the team works on maintaining the content on certain online elements are very generic in nature, like documentation, community wiki, event banners which do not fit in a certain subteam or SIG. -[[about-revamp]] -== Websites & Apps Community Revamp Objective +[[related-teams]] +== Related teams -The team was rebooted in 2021 as a part of the https://fedoraproject.org/wiki/Objectives/Websites_%26_Apps_Community_Revamp[Websites & Apps Community Revamp Objective]. With the onset of this council objective, the team has been growing ever since with developers, designers and project managers having a wide range of skills and interests. Please refer to [this] documentation to learn more about the council objective's purpose and functions. - -[[collaborations]] -== Our collaborations -In order to work in a community with as many diverse projects and stakeholders as the Fedora Project, the team aims to communicate and collaborate regularly with different community members from various subprojects, SIGs and workgroups within Fedora. The activities on specific websites and applications are coordinated by the relevant points of contacts. - -Here is a list of our active collaborators: - -[[collaboration-subteams]] -=== Our subteams -The team is further assisted with three subteams that are distinct in function but integrated in purpose. +In addition to the Websites and Apps Team, we have two other teams we're working closely with. These teams have a specific objective and once that objective has been met, the team will disband and their work adopted by the main Websites and Apps Team. ==== Fedora Websites Revamp Stakeholder Team -The subteam consists of folks from the design team and various other subprojects, SIGs and workgroups where they come up with mockups for the offerings websites, review them and improve upon them continually. - -==== Fedora Websites Engineering Team -The subteam looks into the technical side of things - helping with developing and maintaining the websites in the state that they are in for now, assisting with the issue tickets and onboarding/mentoring contributors. +This team consists of people from the design team and various other subprojects, SIGs and workgroups where they come up with mockups for the offerings websites, review them and improve upon them continually. Once the website revamp work has been completed, the Websites and Apps team will become directly involved to create and deploy the new designs and then maintain them an an ongoing basis. ==== Fedora Websites and Apps Objective Co-leads Team -The subteam looks into the cohesion of the aforementioned two teams - introspecting the current state of the teams, ensure contributors feel rewarded and that the objective outcomes are met. +This team looks into the cohesion of the websites and apps community - introspecting the current state of the teams, attempting to attract new contributors and ensuring existing contributors feel rewarded and that the objective outcomes are met. More information is available on the next page, see our https://docs.fedoraproject.org/en-US/websites/objective/[Counil Objective] page. + +[[collaborators]] +== Our collaborators +In order to work in a community with as many diverse projects and stakeholders as the Fedora Project, the team aims to communicate and collaborate regularly with different community members from various subprojects, SIGs and workgroups within Fedora. The activities on specific websites and applications are coordinated by the relevant points of contacts. -[[collaborations-subprojects]] -=== Fedora sub-projects +[[list-of-collaborators]] +=== List of collaborators ==== https://fedoraproject.org/wiki/Design[*Design Team*] The subproject has been actively helping with creating mockups and wireframes, evaluating user interfaces and providing visual content. From 9c93fa278968b55a5fcfb24356981a4dccc2bf44 Mon Sep 17 00:00:00 2001 From: Graham White Date: Jun 14 2022 07:24:49 +0000 Subject: [PATCH 2/2] Update according to the review from @glb (with thanks!) --- diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc index 3fe4f36..00150e3 100644 --- a/docs/modules/ROOT/pages/index.adoc +++ b/docs/modules/ROOT/pages/index.adoc @@ -7,30 +7,30 @@ Welcome to the official documentation for the Fedora Websites & Apps Team. The [[about]] == About the team -Our websites are of top priority and imporance, being our web-based representation to the wider community of users and contributors. The team works on designing, developing and maintaining user-friendly interfaces. The community-led team consists of voluntary contributors from around the world that are involved in activities such as the following: +Our websites are of top priority and importance, being our web-based representation to the wider community of users and contributors. The team works on designing, developing and maintaining user-friendly interfaces. The community-led team consists of voluntary contributors from around the world that are involved in activities such as the following: * Consolidate key Fedora Project websites into a single uniform scheme: in terms of design (look/feel and UI/UX), engineering (tech stack and implementation) and operation (navigation and content), the team attempts to maintain the websites as consistently as possible. -* Develop frontend and backend components of Fedora's web applications: with the use of frontend tools (HTML, CSS, JavaScript and the related frameworks) and backend tools (Python, Ansible, JavaScript and the related frameworks), the team develops and maintainers the web applications. +* Develop frontend and backend components of Fedora's web applications: with the use of frontend tools (HTML, CSS, JavaScript and the related frameworks) and backend tools (Python, Ansible, JavaScript and the related frameworks), the team develops and maintains the web applications. * Making websites as fun and exciting as the project they represent: a book might not be judged by its cover but a project is likely to be judged by the website it is represented by. The team ensures that the websites precisely represent the project's details and offerings. -* Help maintain content that doesn't fall under any particular subproject: the team works on maintaining the content on certain online elements are very generic in nature, like documentation, community wiki, event banners which do not fit in a certain subteam or SIG. +* Help maintain content that doesn't fall under any particular subproject: much of the content that the team maintains is generic in nature, like documentation, community wiki, event banners which do not fit in a certain subteam or SIG. [[related-teams]] == Related teams -In addition to the Websites and Apps Team, we have two other teams we're working closely with. These teams have a specific objective and once that objective has been met, the team will disband and their work adopted by the main Websites and Apps Team. +In addition to the Websites and Apps Team, we have two other teams we're working closely with. These teams have a specific objective and once that objective has been met, the teams will disband and their work adopted by the main Websites and Apps Team. ==== Fedora Websites Revamp Stakeholder Team -This team consists of people from the design team and various other subprojects, SIGs and workgroups where they come up with mockups for the offerings websites, review them and improve upon them continually. Once the website revamp work has been completed, the Websites and Apps team will become directly involved to create and deploy the new designs and then maintain them an an ongoing basis. +This team consists of people from the design team and various other subprojects, SIGs and workgroups where they come up with mockups for the offerings websites, review them and improve upon them continually. Once the website revamp work has been completed, the Websites and Apps team will become directly involved to create and deploy the new designs and then maintain them on an ongoing basis. ==== Fedora Websites and Apps Objective Co-leads Team This team looks into the cohesion of the websites and apps community - introspecting the current state of the teams, attempting to attract new contributors and ensuring existing contributors feel rewarded and that the objective outcomes are met. More information is available on the next page, see our https://docs.fedoraproject.org/en-US/websites/objective/[Counil Objective] page. [[collaborators]] == Our collaborators -In order to work in a community with as many diverse projects and stakeholders as the Fedora Project, the team aims to communicate and collaborate regularly with different community members from various subprojects, SIGs and workgroups within Fedora. The activities on specific websites and applications are coordinated by the relevant points of contacts. +In order to work in a community with as many diverse projects and stakeholders as the Fedora Project, the team aims to communicate and collaborate regularly with different community members from various subprojects, SIGs and workgroups within Fedora. The activities on specific websites and applications are coordinated by the relevant points of contact. [[list-of-collaborators]] === List of collaborators