From e86e552463a64e8acd324810de28576a6f95feee Mon Sep 17 00:00:00 2001 From: Akashdeep Dhar Date: Jun 28 2022 09:01:44 +0000 Subject: Add basic docs for the revamp stakeholders team --- diff --git a/docs/antora.yml b/docs/antora.yml index bc89f15..fc47658 100644 --- a/docs/antora.yml +++ b/docs/antora.yml @@ -15,4 +15,5 @@ start_page: ROOT:index nav: - modules/ROOT/nav.adoc - modules/engg/nav.adoc +- modules/rvmp/nav.adoc - modules/dev/nav.adoc diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc index 00150e3..31c0197 100644 --- a/docs/modules/ROOT/pages/index.adoc +++ b/docs/modules/ROOT/pages/index.adoc @@ -22,11 +22,14 @@ Our websites are of top priority and importance, being our web-based representat 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 on an ongoing basis. +==== Fedora Websites Revamp Stakeholders 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. ==== 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. +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/[Council Objective] page. [[collaborators]] == Our collaborators diff --git a/docs/modules/engg/pages/meetings.adoc b/docs/modules/engg/pages/meetings.adoc index df6af5c..86f9351 100644 --- a/docs/modules/engg/pages/meetings.adoc +++ b/docs/modules/engg/pages/meetings.adoc @@ -26,7 +26,7 @@ A video conference meeting is a fleeting affair and hence, it is important to us * [_10m_] Engineering updates * [_10m_] Council Objective updates - [_3m_] Mindshare updates - - [_3m_] Stakeholder updates + - [_3m_] Stakeholders updates - [_4m_] General discussion * [_remaining_] Discussion on plans and blockers * Pick a chair for next time! diff --git a/docs/modules/rvmp/nav.adoc b/docs/modules/rvmp/nav.adoc new file mode 100644 index 0000000..1732192 --- /dev/null +++ b/docs/modules/rvmp/nav.adoc @@ -0,0 +1,3 @@ +* xref:index.adoc[Revamp Stakeholders team] +** xref:meetings.adoc[Meetings] +** xref:contact.adoc[Contact us] \ No newline at end of file diff --git a/docs/modules/rvmp/pages/contact.adoc b/docs/modules/rvmp/pages/contact.adoc new file mode 100644 index 0000000..9e746be --- /dev/null +++ b/docs/modules/rvmp/pages/contact.adoc @@ -0,0 +1,25 @@ +include::engg:partial$attributes.adoc[] + += Contact us + +Have questions or want to know more? + +== Connect with us + +Get in touch with our team in the following places: + +=== Asynchronous +** link:{COMMS-DISCOURSE}[Fedora Discussion] +** link:{COMMS-LISTSERV}[Mailing list] + +=== Synchronous +** link:{COMMS-FEDORA-CHAT}[Fedora Chat] + +== Membership + +In order to become a member of the Fedora Websites Revamp Stakeholders Team, the applicant must be registered at link:++https://accounts.fedoraproject.org++[Fedora Accounts] and set up an account with the link:++https://pagure.io++[Pagure] VCS forge. + +By becoming a Fedora Contributor, you accept these terms. + +* link:++https://fedoraproject.org/wiki/Legal:Fedora_Project_Contributor_Agreement++[Fedora Project Contributor Agrement (FPCA)] +* link:++https://docs.fedoraproject.org/en-US/project/code-of-conduct/++[Code of Conduct] diff --git a/docs/modules/rvmp/pages/index.adoc b/docs/modules/rvmp/pages/index.adoc new file mode 100644 index 0000000..ad13dbd --- /dev/null +++ b/docs/modules/rvmp/pages/index.adoc @@ -0,0 +1,20 @@ +include::engg:partial$attributes.adoc[] + += Fedora Websites Revamp Stakeholders Team + +Welcome to the official documentation for the Fedora Websites Revamp Stakeholders Team. + +== Points of contact +- https://accounts.fedoraproject.org/user/pawelzelawski/[Pawel Zelawski] +- https://fedoraproject.org/wiki/User:Siosm[Timothee Ravier] + +== Purpose +The team looks into designing aesthetics, making the style guide, planning the website strategy and deciding the tech stack for delivering Fedora Linux offerings website. + +== Function +1. Multiple contributors from Design team, Server WG, Workstation WG, Kinoite subteam, Fedora Infra subteam, NeuroFedora SIG etc. have been participating in discussions over at the chatroom. +2. Members from the design team have been continually instrumental in coming up with various mockups and improving upon them by getting reviews from within the team and the outer community (Discussion fp.o) +3. Design team representative, Mairin Duffy had been mentoring a set of interns, Emma Kidney and Jess Chitas as well with her endeavours of creating mockups for the Fedora Linux websites. +4. Planning and updates are now recorded in a GitLab subgroup - the creation of which was pursued by the members of this team, contributors from Fedora Infra and those from the Community Platform Engineering team. +5. Meetings have been organized by Pawel Zelawski and attended by the members periodically to catch up on the progress, perform stakeholders reviews and plan on the next tasks. +6. With active representation in the events like Nest With Fedora and Fedora Linux Release Parties, the team had been reaching out to garner more feedback on the work done so far and acquire contributors for assistance. diff --git a/docs/modules/rvmp/pages/meetings.adoc b/docs/modules/rvmp/pages/meetings.adoc new file mode 100644 index 0000000..045a61f --- /dev/null +++ b/docs/modules/rvmp/pages/meetings.adoc @@ -0,0 +1,68 @@ +include::engg:partial$attributes.adoc[] + += Meetings + +The team members collaborate periodically over synchronous and asynchronous meetings. + +== Video conference meetings + +The Websites Revamp Stakeholders Team meets weekly as long as there are at least four active participants available. Should that not be the case - updates, plans and blockers are conveyed asynchronously in the Fedora Chat channel by the members. + +== Agenda +A video conference meeting is a fleeting affair and hence, it is important to use every moment of the meeting wisely to discuss important topics. + +=== Example +The following is a Markdown-styled example agenda to extend from. +[source] +---- +## FORMAT + +### Chair +- ADD YOUR NAME(S) HERE + +### Attendees +- ADD YOUR NAME(S) HERE + +### Check up +- How are you doing? +- How's the weather there? + +### Agenda +- ADD ITEMS HERE +---- + +== How to chair team meetings? +Anyone can be a chair for the Websites Revamp Stakeholders Team, and we encourage everyone to try chairing our weekly team meetings at least once to get an experience. The team is supportive of newcomers and experienced folks alike who are trying to chair a meeting for the first time so one need not worry about anything going wrong midway. + +The chair should + +* Be one of the first ones to join the meeting as they would be the one coordinating with the attendees and carrying the meeting forward +* Have the agenda document open on a side to read topics from, add names to the roster and make notes/summaries/action-items discussed on +* Make sure that all the points from the slated agenda are discussed during the meeting and that the action items, if any, are accounted for +* Ensure that the attendees feel comfortable enough and get a fair amount of time to put their points forward and that their points are considered +* Act as an arbiter to settle disputes, if there are any, among the attendees and try to reach middle ground and avoid conflicts. +* Keep track of "raised hands" in order to ensure that every attendee in the meeting gets their opportunity to speak in the order of "hands raised" +* Let the team know well in advance if they are not able to make it to the meeting that they volunteered to chair for to help get a replacement +* Attempt to prevent diversions in the meeting, be they caused by either themselves or the attendees and try to maximally utilize the meeting time +* Motivate communication in an accessible manner - so folks who are unwilling to use camera and/or microphone should be encouraged to use the chat +* Conduct an in-meeting poll, discussion, opinions, debate in an unbiased and fair manner to all the attendees to avoid any possible conflicts +* Feel comfortable to pass on their turn to someone else mid-meeting, should something important come up or if they cannot attend anymore +* Avoid a survivorship bias by passing on the updates shared and progresses made on the meeting to the wider community using relevant channels +* Make notes on the developments made in a meeting, summarize discussions, plans and action items, or find an assignee from the attendees to do it +* Ensure that they are attending the meeting from a noise-free and disturbance-free environment and are not distracted by any other work or social media +* Use an accessible and simple vocabulary to convey their statements for maximum participation, and wait enough after each point for attendees to reflect + +== Participation guidelines +* Please focus on listening, and on appreciating what others are trying to say, not only on what you are hearing. +* Wherever possible, please refrain from multitasking on email or social media and strive to remain fully present and tuned in to what others are saying and feeling. +* Please assume best intent in everyone's comments and strive to keep a constructive tone in your own. +* Please use simple, accessible language. In particular, please avoid jargon and acronyms, so that all may fully participate. +* When you speak, please make just one point and then let others speak. We want everyone to have an equal chance to speak. In a group of "n" people, speak no more than "1/nth" of the time. +* Please speak for yourself when making comments, using "I". Please don't speak for the assembled group by speaking as "we". +* Help us be mindful of the schedule and stay on time; we anticipate many people will have much they want to say, but please support us in moving the dialog forward. + +== Please be a self-aware participant! +* Please indicate you want to speak by raising your hand on video or with the button in Jitsi Meet; if you are not able to use or raise your hand, feel free to speak up but please try not to interrupt others. +* Please stay muted when you are not speaking. +* Please be mindful of background noise and join the call from a quiet location. Construction sites, windy gardens and non-quarantined internet cafes do not qualify as quiet locations. +* All parents and caregivers shall enjoy an irrevocable "background/foreground kid and dependent noise" exception at all times, but muting etiquette still applies. diff --git a/docs/modules/rvmp/partials/attributes.adoc b/docs/modules/rvmp/partials/attributes.adoc new file mode 100644 index 0000000..ef3e950 --- /dev/null +++ b/docs/modules/rvmp/partials/attributes.adoc @@ -0,0 +1,3 @@ +:comms-discourse: https://discussion.fedoraproject.org/c/project/websites/66 +:comms-listserv: https://lists.fedoraproject.org/archives/list/websites@lists.fedoraproject.org/ +:comms-fedora-chat: https://chat.fedoraproject.org/#/room/#fedora_website_revamp:fedora.im