#1154 Restructure the front page to flow more logically and better describe the team(s)
Merged 2 months ago by t0xic0der. Opened 2 months ago by grahamwhiteuk.
grahamwhiteuk/fedora-websites main  into  main

@@ -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 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.

+ * 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 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.

+ * 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.

  

- [[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 teams 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 on 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 contact.

  

- [[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.

I've restructured the page a little such that it flows better, with 3 distinct sections. To me the existing version has some confusion over the teams involved and I think I've cleared that up as well by described the Websites and Apps Team as well as the co-leads team and website revamp team.

I have a series of questions I think our documentation should be able to answer. To my mind, this PR creates a front page that answers the questions around:

  • Can I find an introduction to the team and/or people involved?

    • Structure of the website and apps projects/teams

s/the team works on maintaining the content on certain online elements are very generic in nature/much of the content that the team maintains is generic in nature/

s/points of contacts/points of contact/

Metadata Update from @thunderbirdtr:
- Pull-request tagged with: docs
- Request assigned

2 months ago

1 new commit added

  • Update according to the review from @glb (with thanks!)
2 months ago

@thunderbirdtr thanks for assigning. Surely I shouldn't be responsible for merging my own PR though?

Metadata Update from @thunderbirdtr:
- Request assigned

2 months ago

LGTM.

Let's do the "limit every line to 80 chars" part later, yeah.

Pull-Request has been merged by t0xic0der

2 months ago