From 9de880030c2bb04150587b0b180b483f70181d65 Mon Sep 17 00:00:00 2001 From: sumantrom Date: Jan 28 2022 06:47:03 +0000 Subject: final update landing page --- diff --git a/docs/antora.yml b/docs/antora.yml index 268fe4f..3362281 100644 --- a/docs/antora.yml +++ b/docs/antora.yml @@ -17,4 +17,5 @@ nav: - modules/teams/nav.adoc - modules/outreach-badges/nav.adoc - modules/design-assets/nav.adoc + - modules/misc-docs/nav.adoc diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc index 073c8ac..e69de29 100644 --- a/docs/modules/ROOT/nav.adoc +++ b/docs/modules/ROOT/nav.adoc @@ -1,4 +0,0 @@ -* How to contribute -** xref:contribute/join.adoc[Join CommOps] -** xref:contribute/successful-contributor.adoc[How to be a successful contributor] -* xref:community-blog.adoc[Community Blog] diff --git a/docs/modules/ROOT/pages/index1.adoc b/docs/modules/ROOT/pages/index1.adoc deleted file mode 100644 index 521289e..0000000 --- a/docs/modules/ROOT/pages/index1.adoc +++ /dev/null @@ -1,271 +0,0 @@ -include::ROOT:partial$attributes.adoc[] - -= Fedora Community Operations (CommOps) - -image::commops-logo.png[CommOps logo] - -Community Operations (CommOps) provides tools, resources, and utilities for different sub-projects of Fedora to improve effective communication. -The following areas are examples of where CommOps focuses: - -* Work closely with xref:council::fcaic.adoc[Fedora Community Action and Impact Coordinator] to prioritize key focus areas -* Assist xref:council::fpgm.adoc[Fedora Program Manager] with release preparations -* Support preparation and execution of https://fedoraproject.org/wiki/Elections[Fedora Elections] -* Work with sub-projects and teams to improve on-boarding methods and practices -* Use metrics and data to improve understanding of Fedora community -** Support development of metrics tooling -* And more (detailed below) - -image::infographic-2020.png[Infographic with statistics about Fedora Community Operations. Created by Smera Goel.] - - -[[find-commops]] -== Where to find CommOps - -The CommOps team uses a {DISCOURSE}[Discourse] forum and https://en.wikipedia.org/wiki/Internet_Relay_Chat[IRC] channel to communicate. - -The {DISCOURSE}[Discourse forum] is best for _asynchronous_ communication. -This means it is best for questions or topics that someone may respond to later. -It is better for longer, threaded discussions. - -The CommOps IRC channel on the https://libera.chat/[Libera.chat IRC network] is best for _synchronous_ communication. -This means it is best for quick feedback, like in a conversation. -It is helpful for real-time discussions or getting someone's attention. -Additionally, the CommOps IRC channel is bridged to a Telegram group, if Telegram is more convenient. - -Discourse forum:: {DISCOURSE}[{DISCOURSE}] -IRC channel:: https://libera.chat/[#fedora-commops] on Libera.chat -Telegram group:: https://t.me/fedoracommops[@fedoracommops] on Telegram - -First time using IRC? -Look into https://opensource.com/article/17/5/introducing-riot-IRC[Riot], a free and open source client that connects to various IRC networks. -Riot also keeps you connected to IRC even when you're not connected to the Internet. - - -[[workflow]] -== Workflow - -CommOps uses a ticket-based workflow to keep track of our work. -The repository with tickets is found on https://pagure.io/fedora-commops[pagure.io/fedora-commops]. -Tickets are found under the _https://pagure.io/fedora-commops/issues[Issues]_ menu. - -Various tags are listed at the top of the _Issues_ page. -For good beginner tasks, look at the _https://pagure.io/fedora-commops/issues?status=Open&tags=good+first+issue[good first issue]_ tag. - - -[[meetings]] -== Meetings - -CommOps holds a meeting once a week on IRC to check in on tasks and plan ahead. -Check the https://apps.fedoraproject.org/calendar/commops/[CommOps calendar] for the current date and time. - -Past meeting minutes are recorded in https://meetbot.fedoraproject.org/teams/commops/[Meetbot]. - - -[[meeting-format]] -=== Meeting format - -The upcoming meeting agenda is found on the Fedora https://infinote.fedoraproject.org/cgit/infinote/tree/meeting-templates/fedora-commops-meeting-next[Infinote server]. -Meetings follow an agenda split into five parts: - -. **Roll call**: Waiting for others to arrive, opportunity to introduce yourself and ask general questions -. **Announcements**: Any news or updates to share -. **Action items from last meeting**: Follow-up on `#action` items from previous meeting -. **Tickets**: Discussion and follow-up on tickets https://pagure.io/fedora-commops/issues?status=Open&tags=meeting[marked for meetings] -. **Open floor**: General discussion or comments - - -[[what-commops-does]] -== What CommOps does - -CommOps focuses on a few key areas, both technical and non-technical. - -=== Culture - -The Fedora Project builds and ships a Linux distribution, but there is a community behind the technical work and planning. -In Fedora, we have the xref:project::index.adoc#_what_is_fedora_all_about[Four Foundations] to represent our community culture. -The Fedora community represents a set of ethics and values to how we build our distribution. -These ethics and values create the culture of the Fedora Project. -When working in the community, mindfulness of this culture enriches and supports the different sub-communities inside of Fedora. - -CommOps builds community infrastructure of support and acceptance for the Fedora community's culture. -The _Friends_ foundation is there for a reason. -The community infrastructure CommOps assists with builds on top of the _Friends_ foundation. -People enjoy contributing in a community where they feel valued for who they are and what they bring to the community, not just that they are useful. -CommOps supports this through some of our tasks relating to culture. - -Examples of things we help with to build and support the culture of the Fedora community: - -* https://pagure.io/fedora-commops/issue/17[Interviewing Fedora community members] -* https://pagure.io/fedora-commops/issue/110[Fedora Appreciation Week] -* https://pagure.io/fedora-commops/issue/138[Top Badgers of the Year] - -=== Elections - -There are a few elected bodies in Fedora: the xref:project::leadership.adoc[Fedora Council], xref:mindshare::index.adoc[Mindshare Committee], and xref:fesco::index.adoc[FESCo]. -Every new Fedora release, the community holds elections for these bodies. -Each election takes "wrangling" work to pull it together. -This includes calling for nominations, conducting interviews with candidates, and raising awareness during the voting window. - -CommOps supports the xref:council::fpgm.adoc[Fedora Program Manager] in organizing and executing elections. -These responsibilities consist of curating content on the xref:community-blog.adoc[Community Blog], creating interview templates, and outreach to grow awareness. - -Examples of things we do to help organize and execute Fedora elections: - -* https://pagure.io/fedora-commops/issue/7[Fedora Elections and CommOps Coverage] -* https://pagure.io/fedora-commops/issue/19[Improve automation of Elections communication] -* https://pagure.io/fedora-commops/issue/93[Better explain roles of Council and FESCo] -* https://pagure.io/fedora-commops/issue/107[Automated Fedocal reminders to send to all mailing lists for upcoming Elections] -* https://pagure.io/fedora-commops/issue/112[Create August 2017 election interview templates for candidates] - -=== Storytelling - -Messaging and storytelling bring the Fedora Project "story" to both contributors and user communities. -Every year, a https://mattdm.org/fedora/2018flock/2018-State-of-Fedora.pdf[couple thousand people] work on Fedora. -Messaging is a way of sharing our story in multiple formats. -We bring the message of what we _as a community_ are doing out to others. -Others include our contributors working in other areas of the project and users interested in what the Fedora community produces. -When we share our story with each other, we are aware of other work happening in the Fedora community. -Communicating the story of Fedora keeps our contributors moving together towards our goals. -Good messaging helps our users better understand the goals and objectives of Fedora and how we plan to get there. - -CommOps supports messaging by working with other sub-projects and teams to tell their own stories. -CommOps provides help to "dig out" the stories and tools to share them widely. -This includes tasks like interviews, sharing activities by Fedora contributors, running retrospectives, and more. -These tasks keep contributors in sync with what we're working on. -They are direct actions to keep everyone on the same page. - -Examples of things we do to support messaging and tell stories: - -* https://pagure.io/fedora-commops/issue/4[Interviews about goals for team sprints] -* https://pagure.io/fedora-commops/issue/66[Call for nominations of a Working Group] -* https://pagure.io/fedora-commops/issue/98[Covering upcoming talks by Fedora contributors at a major conference] -* https://pagure.io/fedora-commops/issue/100["Help Wanted" columns] -* https://pagure.io/fedora-commops/issue/129[Year in Review blog series] - -=== Metrics - -CommOps measures community health and engagement through extensive metrics and data available about Fedora. -{FEDMSG}[fedmsg] is a messaging bus with data about activity in the Fedora community. -The data includes activity like git commits, new blog posts, wiki page edits, software build status, IRC meeting notes, and more. -CommOps works with fedmsg to tell stories about our community, but specific types of stories. -The stories told with metrics are helpful to understand what we may be doing right or wrong. -It gives us a data-driven way to understand our huge community. - -CommOps directly supports metrics in Fedora through development time and data-driven storytelling. -Some members develop existing software or build new scripts to analyze data. -Others use the data to write reports or studies on how the Fedora community works. -Ultimately, metrics are a largely technical area that CommOps helps with. - -Examples of metrics work and data-driven storytelling we do: - -* https://pagure.io/fedora-commops/issue/32[Analyzing Fedora contributor activity] -* https://pagure.io/fedora-commops/issue/88[Fedora release party metrics] -* https://pagure.io/fedora-commops/issue/109[Understanding contributor activity by geographic location] - -=== Supporting sub-projects - -CommOps assists other sub-projects and teams in following best practices and communicating effectively. -We work with other teams to help them on-board new contributors into their teams. -This includes creating Fedora Badge requests, reviewing guidelines, and making Fedora services and tools more understandable. - -Examples of sub-project support and on-boarding work: - -* https://pagure.io/fedora-commops/issue/62[Wiki gardening of Fedora Join] -* https://pagure.io/fedora-commops/issue/69[Fedora Modularity onboarding] -* https://pagure.io/fedora-commops/issue/76[Update Onboarding Calendar for GSoC 2016] -* https://pagure.io/fedora-commops/issue/95[Onboarding: DotNet SIG] - - -[[join-commops]] -== Join CommOps - -Read our guide on xref:contribute/join.adoc[how to join the CommOps team]. - -CommOps always welcomes new contributors. -Whether you are a newcomer or an old-timer, there are ways to get involved. -Join CommOps to: - -* Build your portfolio in open source community management -* Directly see the impact of your contributions over time -* Gain a holistic view of the Fedora Project and learn how the pieces fit together -* Work directly with Fedora Project leadership -* Work with teammates from around the world -* Aspire to the greatness of a community superheroine or superhero - -.Join the CommOps team today -[link="contribute/join/"] -image::https://fedoraproject.org/w/uploads/7/72/Happypanda.png[Happy Panda,100] - - -[[toolbox]] -== Toolbox - -The CommOps toolbox explains tools and services often used by the team. -The tools are organized by purpose and use. - -[[communication-tools]] -=== Communication tools - -These are communication tools to share content and information with others in the Fedora community. - -xref:community-blog.adoc[Community Blog] (CommBlog) - https://communityblog.fedoraproject.org/[communityblog.fedoraproject.org]:: -Centralized blog for contributors to publish news, activities, or calls for help to the rest of the project. -Useful place for getting an inside scoop on "what's happening" in Fedora. - -https://infrastructure.fedoraproject.org/cgit/ansible.git/tree/roles/fedmsg/irc/templates/ircbot.py?id=0279643#n77[ircbot.py]:: -Python script for fedmsg notifications in https://libera.chat/[#fedora-commops]. -Relays real-time updates and changes relating to CommOps in our IRC channel. - - -[[metrics-tools]] -=== Metrics tools - -These tools access and use the Fedora messaging bus, {FEDMSG}[**fedmsg**]. -With these tools, you can generate metrics, analyze data, and interact with fedmsg. - -https://github.com/fedora-infra/fedora-stats-tools/blob/develop/annualgrepper.py[annualgrepper]:: -Gather raw fedmsg totals on https://fedora-fedmsg.readthedocs.io/en/latest/topics.html[topics] in the last year - -https://pagure.io/cardsite[cardsite]:: -Live fedmsg tracker inspired by http://emojitracker.com/[emojitracker] - -https://github.com/fedora-infra/fedora-stats-tools/blob/develop/daily-briefing.py[daily-briefing.py]:: -Template that takes lists of URLs, generates summary reports of daily Meetbot links and action items (manual now, can be automated!) - -https://apps.fedoraproject.org/datagrepper/[datagrepper]:: -The powerhouse tool to interact with fedmsg. -Using HTTP GET requests, query for historical data from fedmsg. -Examples include events by username, by package, by message source, and more. - -{FEDMSG}[fedmsg]:: -Python package and API that hooks into various Fedora Infrastructure services. -Sends messages from each service to a unified message bus in real-time. -fedmsg drives and powers all the metrics tools we have. - -https://github.com/fedora-infra/fedora-stats-tools[fedora-stats-tools]:: -Multiple statistics tools, data, and slide decks for fedmsg metrics, Year in Reviews, and Fedora event metrics - -https://pagure.io/feedcloud[feedcloud]:: -Takes an RSS feed or list of RSS feeds and generates fancy word-clouds for them - -https://pagure.io/gsoc-stats[gsoc-stats]:: -Python tool to generate statistics about Fedora contributors - -https://github.com/fedora-infra/fedora-stats-tools/blob/develop/longtail-analyze.py[longtail-analyze.py], https://github.com/fedora-infra/fedora-stats-tools/blob/develop/longtail-gather.py[longtail-gather.py]:: -Measure the ratio of activity per user to approximate burnout - -https://github.com/fedora-infra/fedora-stats-tools/blob/develop/meetbot-fedmsg-activity.py[meetbot-fedmsg-activity.py]:: -Jinja2 template that creates links to Meetbot activities - -https://pagure.io/wordcloudbot[wordcloudbot]:: -Create pretty wordclouds from IRC meeting logs - - -[[other]] -=== Other - -Other tools that don't belong elsewhere fit under here. - -https://github.com/OSAS/rh-events[OSAS/rh-events]:: -Data for Red Hat conference and talk attendance. -Useful for plotting events in our own calendar and keeping track of what's happening in the open source community. diff --git a/docs/modules/teams/assets/images/commops-logo.png b/docs/modules/teams/assets/images/commops-logo.png new file mode 100644 index 0000000..c868704 Binary files /dev/null and b/docs/modules/teams/assets/images/commops-logo.png differ diff --git a/docs/modules/teams/assets/images/infographic-2020.png b/docs/modules/teams/assets/images/infographic-2020.png new file mode 100644 index 0000000..96ecb7a Binary files /dev/null and b/docs/modules/teams/assets/images/infographic-2020.png differ diff --git a/docs/modules/teams/assets/images/infographic-2020.svg b/docs/modules/teams/assets/images/infographic-2020.svg new file mode 100644 index 0000000..ae80410 --- /dev/null +++ b/docs/modules/teams/assets/images/infographic-2020.svg @@ -0,0 +1,1768 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + Community Operations provides tools, resources, and utilities for different sub-projects of Fedora for effective communication.IRC: #fedora-commops@LiberaChat Matrix: #commops:fedoraproject.org + + + + FEDORA COMMOPS + + + + The Community Blog provides a single source for members of the community to share important news, updates, and information about Fedora with others in the Project community. + + + FEDORA APPRECIATION WEEK + Fedora Appreciation Week is an annual eventorganized by the Fedora Community Operations (CommOps) team. Fedora Appreciation Week, abbreviated as FAW, is a week-long event to celebrate efforts of Fedora Project contributors and to say "thank you" to each other. + To learn more about the Fedora Project visit: getfedora.org + + + + + + + COMMUNITY BLOG + + 55 authors + + + + + + + + + + + + + + + + + + + + + + + + + + 42,506 page views + + 212 posts + + + + + + 212 + + + + + + + + + + + + + + + + + + + + + + + + + + + Contributor Stories are just that: the record of our best moments with our Fedora friends. The story can be about our work in Fedora or something personal or unique which you would like to share with the community. Selected stories are shared on the Community Blog every day during Fedora Appreciation Week. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + CONTRIBUTOR STORIES + + diff --git a/docs/modules/teams/nav.adoc b/docs/modules/teams/nav.adoc index c22e2b5..6dc4d10 100644 --- a/docs/modules/teams/nav.adoc +++ b/docs/modules/teams/nav.adoc @@ -1,4 +1,4 @@ -* *Teams* +* Teams ** Ambassador *** xref:ambassadors.adoc[Team Overview] *** xref:ambassador-role.adoc[Roles] @@ -11,16 +11,20 @@ *** xref:ambassador-mentor.adoc[Ambassador Mentor] **** xref:ambassador-mentor-role.adoc[Roles] ** Advocate -*** xref:advocate-team-overview.adoc[Team Overview] +*** https://docs.fedoraproject.org/en-US/mindshare-committee/advocate/[Team Overview] *** xref:advocate-role.adoc[Roles] *** xref:advocate-logo.adoc[Logos] *** xref:advocate-badges.adoc[Badges] ** CommOps -*** https://docs.fedoraproject.org/en-US/commops/index1.adoc[Team Overview] +*** xref:commops.adoc[Team Overview] *** xref:commops-role.adoc[Member Roles] *** xref:mindshare-reps.adoc[Rep Roles] *** xref:commlogo.adoc[Logos] *** xref:commbadges.adoc[Badges] +*** xref:community-blog.adoc[Community Blog] +*** How to contribute +**** xref:contribute/join.adoc[Join CommOps] +**** xref:contribute/successful-contributor.adoc[How to be a successful contributor] ** Join *** https://docs.fedoraproject.org/en-US/fedora-join/[Team Overview] *** https://docs.fedoraproject.org/en-US/fedora-join/welcome/welcome/[Role] @@ -28,6 +32,9 @@ *** xref:join-badges.adoc[Badges] ** Marketing *** xref:marketing.adoc[Team Overview] -*** xref:marketing-role.adoc[Roles] *** xref:marketing-logo.adoc[Logos] *** xref:marketing-badges.adoc[Badges] +** Misc Documentation +*** xref:irc-group-contact.adoc[IRC/Libera Group Contacts] + + diff --git a/docs/modules/teams/pages/appreciation-week.adoc b/docs/modules/teams/pages/appreciation-week.adoc new file mode 100644 index 0000000..1059a6a --- /dev/null +++ b/docs/modules/teams/pages/appreciation-week.adoc @@ -0,0 +1,91 @@ +include::ROOT:partial$attributes.adoc[] + += Fedora Appreciation Week + +Fedora Appreciation Week is an annual event organized by the Fedora xref:index.adoc[Community Operations] (CommOps) team. +Fedora Appreciation Week, abbreviated as FAW, is a week-long event to celebrate efforts of Fedora Project contributors and to say "thank you" to each other. +FAW is normally held on the week of November 6th to coincide with the https://www.redhat.com/archives/fedora-announce-list/2003-November/msg00000.html[anniversary] of the Fedora Project. + + +== What is it? + +The https://wiki.ubuntu.com/UCADay[Ubuntu Community Appreciation Day] inspired CommOps to organize a similar event of appreciation for contributors who make the Fedora community what it is. +This includes all types of contributors: development, design, infrastructure, marketing, engineering, and more. +During the week, anyone is encouraged to select an individual or a group of contributors to thank for their efforts in Fedora. +Appreciation can be given as an IRC karma cookie, a short note of thanks on a mailing list, or a longer form of appreciation (e.g. a https://happinesspackets.fedorainfracloud.org/[Fedora Happiness Packet]), + + +== Why do it? + +Most Fedora contributors do not get to work together in the same building or office. +Our daily interactions are usually in text form (e.g. IRC, emails, wikis, etc.). +Even though these work well and we accomplish our goals, we lose touch with the human side of contributing. +Fedora contributors aren’t robots, but real people! +Fedora Appreciation Week is a chance to remember the Fedora community is a community of people, and to thank our colleagues and friends who might be halfway across the room or halfway across the planet. + + +== How to participate + +Different ways to participate in Fedora Appreciation Week are explained below. +Consider using one or many of the methods below to participate. + +=== Write a Contributor Story + +https://pagure.io/fedora-commops/contributor-stories[Contributor Stories] are just that: the record of our best moments with our Fedora friends. +The story can be about our work in Fedora or something personal or unique which you would like to share with the community. +Selected stories will be shared on the Community Blog every day during Fedora Appreciation Week. + +See some https://pagure.io/fedora-commops/contributor-stories/issues?status=all[examples] and consider https://pagure.io/fedora-commops/contributor-stories/new_issue[writing one of your own]. + +=== Submit and vote on your favorite community pictures + +More coming soon (see https://pagure.io/fedora-commops/issue/110#comment-531973[discussion]). + +=== Send a Fedora Happiness Packet + +Happiness Packets are public or private notes of thanks you can send as emails to other contributors. +The Fedora Happiness Packets (*FHP*) project launched as part of {COMMBLOG}/happiness-packets-fedora-gsoc-2018/[Fedora Summer Coding 2018]. +It is a fork of https://www.happinesspackets.io/[happinesspackets.io]. +FHP supports FAS account login and account search. +You can earn a Fedora Badge by sending a message of gratitude or thanks to another contributor. + +https://happinesspackets.fedorainfracloud.org/[**Send one now!**] + +=== Write your appreciation === + +You can also consider other ways of sharing and writing your appreciation for someone else and what they bring to our community. +If you are not sure of a specific person, you can also tweet general appreciation of Fedora, as operating city or as community. +Consider these ideas: + +* Write a blog post +* Tweet a "thank you" that mentions https://twitter.com/fedora[@fedora] +* Tweet a hat tip / thanks to another Fedora contributor with hashtag *#_WeAreFedora_* + + +== Press + +This section is a running list of press coverage of Fedora Appreciation Week: + +=== 2018 + +* *2018-05-01*: {COMMBLOG}/contributor-stories/[Introducing Contributor Stories] - {COMMBLOG}[_communityblog.fedoraproject.org_] +* *2018-08-09*: https://www.youtube.com/watch?v=wV8j2xt8pmw[Flock 2018 - Thank the Fedora Community! Launching Fedora Appreciation Week] - https://youtube.com[_youtube.com_] +* *2018-09-18*: {COMMBLOG}/fedora-appreciation-week-2018/[Say thank you this November during Fedora Appreciation Week 2018] - {COMMBLOG}[_communityblog.fedoraproject.org_] +* *2018-10-29*: https://fedoramagazine.org/say-thanks-appreciation-week-2018/[Say thanks during Fedora Appreciation Week (Nov. 5-11)] - https://fedoramagazine.org[_fedoramagazine.org_] +* *2018-10-29*: https://www.linuxjournal.com/content/fedora-appreciation-week-qt-announces-deprecation-qbs-d-language-front-end-merged-gcc[Fedora Appreciation Week, Qt Announces the Deprecation of Qbs…] - https://www.linuxjournal.com[_linuxjournal.com_] +* *2018-11-09*: https://fedoramagazine.org/appreciate-fedora-2018/[How Do You Appreciate Fedora?] - https://fedoramagazine.org[_fedoramagazine.org_] + +==== Appreciation Week highlights + +* *2018-11-05*: {COMMBLOG}/faw-2018-day-1-community-makes-the-difference/[FAW 2018 Day 1: “Community makes the difference”] - {COMMBLOG}[_communityblog.fedoraproject.org_] +* *2018-11-06*: {COMMBLOG}/faw-2018-day-2-change-the-world-through-open-source/[FAW 2018 Day 2: “Change the world through Open Source. He said.”] - {COMMBLOG}[_communityblog.fedoraproject.org_] +* *2018-11-07*: {COMMBLOG}/faw-2018-day-3-becoming-part-of-fedora-family-because-of-her/[FAW 2018 Day 3: “Becoming part of Fedora family because of her!”] - {COMMBLOG}[_communityblog.fedoraproject.org_] +* *2018-11-08*: {COMMBLOG}/faw-2018-day-4-you-know-you-can-do-it/[FAW 2018 Day 4: “You know you can do it”] - {COMMBLOG}[_communityblog.fedoraproject.org_] +* *2018-11-09*: {COMMBLOG}/faw-2018-day-5-encouraging-crazy-ideas/[FAW 2018 Day 5: “Encouraging crazy ideas”] - {COMMBLOG}[_communityblog.fedoraproject.org_] + +==== Community appreciation + +* *2018-11-06*: https://blog.justinwflory.com/2018/11/fedora-appreciation-week-tribute-to-a-legacy/[Fedora Appreciation Week: Tribute to a legacy] - https://blog.justinwflory.com/[_blog.justinwflory.com_] +* *2018-11-06*: https://blog.hildenco.com/2018/11/thank-you-fedora.html[Thank You, Fedora] - https://blog.hildenco.com/[_blog.hildenco.com_] +* *2018-11-10*: https://forums.fedoraforum.org/showthread.php?319858-Fedora-appreciation-week[Fedora appreciation week] - https://forums.fedoraforum.org/[_forums.fedoraforum.org_] +* *2018-11-10*: https://lushka.al/thank-you-fedora/[Thank you, Fedora] - https://lushka.al/[_lushka.al_] diff --git a/docs/modules/teams/pages/community-blog.adoc b/docs/modules/teams/pages/community-blog.adoc new file mode 100644 index 0000000..9a7e3a4 --- /dev/null +++ b/docs/modules/teams/pages/community-blog.adoc @@ -0,0 +1,112 @@ +include::ROOT:partial$attributes.adoc[] + += Community Blog + +The {COMMBLOG}[Fedora Community Blog] (CommBlog) is a WordPress-based site that delivers news, updates, and calls for help from contributors across Fedora. + +image::https://fedoraproject.org/w/uploads/0/09/Community_Blog_screenshot.png[Community Blog screenshot,90%,90%] + + +[[content]] +== Content + +The Community Blog focuses on updates and information about the Fedora Project community. +Topics vary, but mostly include… + +* News from specific sub-projects +* Updates on new features or changes in Fedora +* Calls for help from other contributors +* Official {FWIKI}/Elections[Fedora Elections] coverage +* Anything related to Fedora _contributor_ community + + +[[magazine-vs-community-blog]] +== Fedora Magazine vs. Community Blog + +What is the difference between the https://fedoramagazine.org[Fedora Magazine] and the Community Blog? +They focus on two different audiences (or types of readers). + +The Fedora Magazine targets everyday Fedora users, Linux enthusiasts, and technology hobbyists. +Fedora contributors are included in these audiences, but they are not the main focus. +The Community Blog is the news hub for Fedora contributors and people working inside of the Fedora community. +The Community Blog specifically focuses on our contributors. + +For example, an article on how to use a new package in Fedora is better for the Magazine. +Any Fedora user may be interested in using the package. +An article that announces a new feature to a Fedora Infrastructure service or an Ambassador event report is better for the Community Blog. +A Fedora user may not be interested, but our contributors have a stronger interest. + +Sometimes there is some overlap between the two. +Think hard about who you are writing for and who you want to read your article. +This should answer the question of where to write your article. +The CommOps and Fedora Magazine teams are happy to answer any doubts or questions if you are unsure. + + +[[write-article]] +== Write an article + +The Community Blog is managed by the CommOps team. +The system administration is managed by {FWIKI}/Infrastructure[Fedora Infrastructure]. +However, we need _your help_ to share the awesome things you and your area of Fedora are working on. + +Articles don't need to be long. +Short snippets are useful too. +If you're not sure how much to write, 300 words is a good target. +If needed, you can always write more. + +See the {COMMBLOG}/writing-community-blog-article/[Writing an article] guide to get started. +This page explains the process for writing and how to get your post published. + + +[[community-blog-theme]] +== Community Blog theme + +The Community Blog WordPress theme is open source. +Find the source code https://pagure.io/communityblog-theme[on Pagure]. +Open a ticket if you find a bug, problem, or something to improve. +Pull requests are also welcome! +Before submitting a pull request, post to the {DISCOURSE}[CommOps Discourse forum] first and ask for feedback on your planned contribution. + + +[[editors]] +== Editors + +Community Blog editors review article drafts and schedule new posts. +Editors are reachable on the {DISCOURSE}[CommOps Discourse forum]. +The Discourse forum is the best way to reach an editor. + +Below, you can find a current list of editors: + +.Community Blog editors +|=== +|Name |FAS account |IRC nickname + +|Ben Cotton (_editor-in-chief_) +|{FWIKI}/User:Bcotton[bcotton] +|bcotton + +|Brian Exelbierd +|{FWIKI}/User:Bex[bex] +|bexelbie + +|Brian Proffitt +|{FWIKI}/User:Bproffit[bproffit] +|bkp + +|Jona Azizaj +|{FWIKI}/User:Jonatoni[jonatoni] +|jonatoni + +|Matthew Miller +|{FWIKI}/User:Mattdm[mattdm] +|mattdm + +|Nick Bebout +|{FWIKI}/User:Nb[nb] +|nb + +|Sumantro Mukherjee +|{FWIKI}/User:Sumantrom[sumantrom] +|sumantrom + +|=== diff --git a/docs/modules/teams/pages/contribute/join.adoc b/docs/modules/teams/pages/contribute/join.adoc new file mode 100644 index 0000000..de4a8e5 --- /dev/null +++ b/docs/modules/teams/pages/contribute/join.adoc @@ -0,0 +1,104 @@ +include::ROOT:partial$attributes.adoc[] + += Join Community Operations + +Become a member of Fedora Community Operations (CommOps) by following these steps. + + +[[fas]] +== Create a FAS account + +Create a {FWIKI}/Account_System[Fedora Account System account] and sign the {FWIKI}/Legal:Fedora_Project_Contributor_Agreement[Fedora Project Contributor Agreement]. +Do this through the https://admin.fedoraproject.org/accounts/[Fedora Account System]. + + +[[discourse]] +== Log into Fedora Discourse + +Log into the {DISCOURSE}[Fedora Discourse forum] using your FAS account credentials. +News, updates, and discussion are shared through on the forum. +It is a *key part* to how we communicate. +It receives low to medium traffic. + + +[[introduction]] +== Post a self-introduction + +Say hello and introduce yourself to the team! +{DISCOURSE}[Post a self-introduction] to the Discourse forum and tell us a little about yourself. + +Not sure what to say? +Answer these questions to start: + +* Why are you interested in contributing to Fedora? +* Why are you interested in contributing to CommOps? +* If you're involved with other things in Fedora, what are/were you working on? +* Do you have any experience in open source or online communities? If so, what? +* What parts of CommOps were interesting to you? +* Do you have any questions for us? How can we help _you_ get started? + + +[[community-blog]] +== Register on Community Blog + +The Fedora {COMMBLOG}[Community Blog] is a key component to CommOps. +An account gives permissions to view article drafts and previews before they are published. +If you ever write an article, you will need an account. +To register, log in at the {COMMBLOG}/wp-login.php[login page] with your Fedora Account System (FAS) credentials. + +Need more help logging in? +Read the {COMMBLOG}/how-to-log-in/[help page] for more detailed instructions. + + +[[irc]] +== Join our IRC channel + +Fedora uses the https://libera.chat/[Libera.chat IRC network] for instant messaging and communication. +Short discussions and planning happen in our IRC channel #fedora-commops. +Our monthly team meetings also take place on IRC. + +Never used IRC before? +See the https://fedoramagazine.org/beginners-guide-irc/[Beginner's Guide to IRC] on the Fedora Magazine. +Additionally, you can connect temporarily in a chat session in your browser via https://web.libera.chat/[Libera.chat web chat]. +However, if you want to stay connected even when you are not online, consider https://opensource.com/article/17/5/introducing-riot-IRC[using Riot] as your IRC client. + +For convenience, the IRC channel is bridged to a Telegram group, https://t.me/fedoracommops[@fedoracommops]. +You may also participate via the Telegram group, but you are unable to use or interact with IRC bots (e.g. in meetings). +Join the group at https://t.me/fedoracommops[t.me/fedoracommops]. + + +[[first-steps]] +== Make your first steps + +See xref:contribute/first-steps.adoc[Make your first steps in Fedora] for more info. + + +[[start-task]] +== Start on a task + +CommOps uses https://pagure.io/fedora-commops[this Pagure repository] to track our tasks and what we're working on. +Tasks, problems, and goals are filed as tickets in the https://pagure.io/fedora-commops/issues[issue tracker]. +There are a lot of tickets, but we're not working on everything at once. +Scrolling through the issue tracker gives a good idea of what CommOps helps with. + +Look for the https://pagure.io/fedora-commops/issues?status=Open&tags=good+first+issue[good first issue] tag on tickets to find good tasks for beginners. + +Does something look interesting? +Leave a comment if you have a question or want to work on something. +Also check and see if the ticket is assigned to someone. +If it is unassigned, you can start working on it now. +If there is an assignee, ask them if they need help or if they are still working on the ticket. + +This provides an opportunity to receive mentorship and get help to start a new task. + + +[[meetings]] +== Join our meetings + +CommOps has an IRC team meeting each week. +In our meeting, the team discusses items on our agenda and checks in on any progress of current tasks. +Tickets selected for meetings are updated after the meeting with new information. + +The meetings are open to the public and anyone can join. +See when our meetings are in your time zone on the https://apps.fedoraproject.org/calendar/commops/[CommOps meeting calendar]. +Feel free to attend and introduce yourself during roll call! diff --git a/docs/modules/teams/pages/contribute/successful-contributor.adoc b/docs/modules/teams/pages/contribute/successful-contributor.adoc new file mode 100644 index 0000000..0f4fb56 --- /dev/null +++ b/docs/modules/teams/pages/contribute/successful-contributor.adoc @@ -0,0 +1,88 @@ +include::ROOT:partial$attributes.adoc[] + += How to be a successful contributor + +Audience for this document +-------------------------- +This document is targeted at people interested in contributing to the Fedora Project. In the Fedora Project, students, professionals and hobbyists all come together to produce software, marketing materials, art, documentation, etc. We all started as new volunteers at some point. The items below are designed to help you through the process of joining a team. It helps you know what we expect of you and what you can expect of us. + +Things to know before you join +------------------------------ +So you think that you would enjoy being a successful contributor to Fedora. Great!! You are most welcome. Here are some thoughts to consider. Everyone who joins a free software project does so with the best intentions of staying. A few stay to become regular contributors, and fewer still become leaders within the project, and others lose interest. The biggest difference between those that stay and those that leave is "commitment and time". + +Time commitment +--------------- +A commitment requires reserving some time. If you strongly believe you will enjoy what you are doing, consider your dedication of time. Time commitment is as little as 4 hours per week. Some volunteers may spend 15-30 hours per week contributing. Doing that level of commitment while holding down a proper day job is a difficult time management skill. As a volunteer, you should ask yourself whether you can devote 2-4 hours per week, even though it's less than an hour per day. Four hours a week for most people is an entire afternoon one day. That's a significant chunk of time. + +Get permission from work and family +----------------------------------- +Volunteering has great rewards in many ways. The two most prominent ones are your success at introducing a person to Fedora, another is your own ego. A third benefit is with your job. + +There is a mutually beneficial relationship between working for a living and volunteering. Many contributors will find their skill sets at work increase dramatically just by having access to and learning from another environment. This volunteering benefits employer and worker. It is completely worthwhile to sit down with your employer and ask for permission to contribute during work hours, even if it's only a couple of hours on a Friday afternoon. If you are married, make sure your family agrees to your being busy for this time commitment. Your volunteering must be a win-win-win for the company, your family and you. Explain the benefits to you, to the business, and your family. Family is the important people in your social life. (spouse, friends, parents, others). + +If work says no, then you will have to volunteer in your own time. Your family may be enthusiastic to help you. Volunteering is very rewarding. + +Joining +------- + +The single biggest mistake most new contributors make is showing up "just wanting to contribute." It's important to take the time to observe the team (refer to the section below) and see how their work aligns with your own skills and personality. Know that getting work to do on day one is very rare, and those who are highly skilled in a specific technology will still have to take the time to get to know an environment before access is granted. + +For example, if you're a database expert it is very unlikely you'll be given access to databases (where personal info, passwords, etc are stored) within your first several weeks of volunteering. If you're looking to become an ambassador, it is unlikely you'll get marketing materials shipped to you in your first week. This may seem unfortunate, but it's necessary to keep the project members working well together. The same can be said about any major changes, like a complete redesign of a system or a new look and feel for a website. Don't get discouraged. Show up as often as you can, and get to know the team. + +Observation +----------- + +It is important to get to know the organization and teams you are looking to work with before you try to join them. Learn what they do and how they do it, and try to get to know the people involved. It is extremely unlikely you will be able to actually contribute from day one. In organizations with hundreds or thousands of people working together, understanding how things work is critical. + +Don't be shy about asking questions and getting to know people. Plan to spend several days or even weeks attending meetings, emailing on mailing lists and hanging out on IRC before you get to do any actual work. Offer suggestions on topics being discussed, and share any experiences (good or bad) you've had that is relevant to the discussion. + +Part of observing and making constructive suggestions may require withholding judgment. When making suggestions, don't assume you come with all of the answers or that the Fedora Project is ''doing it all wrong.'' There is a good chance we can improve the way we are doing things, however most of our current practices were developed over long periods of time after lengthy discussion. Your criticism may be better received once you have established yourself in the community and are perceived as understanding our culture. + +Pick what you want to work on +----------------------------- + +It's your job to decide what you want to work on. Pick something that's important to you and something you have passion for. You'll see this advice repeated several times in this document: Don't just show up looking to have work assigned to you. Get to know the teams and procedures they have in place. Ask questions and really get to know what you're going to be working on _before_ trying to work on it. + +Don't jump into the deep end +---------------------------- + +When picking something to work on, don't be the sole person to take on a huge task as your first contribution. Picking a task that's too large significantly raises the chances of failure. Also don't pick several things on several teams to work on. Start small, picking at most one or two things, and grow from there. The key is slow, steady, and sustainable growth. Don't join with the immediate goal of becoming the next leader of the project. Start small. + +First contact +------------- +After you've decided what you're looking to do and what team you are looking to do it with, it's time to send an introduction to the list. When sending an introduction (usually by mail list), include the following information: + +* Name +* Time Zone / Country +* Basic skills and experiences +* Why you're joining +* What you're looking to do (be specific) +* How much time you can contribute (usually hours per week) + +If any of the above questions are not clearly answered, don't send the email yet. You're not ready. Remember, be specific about what type of work you're looking to do. Saying "Whatever needs to get done" isn't helping anyone. Saying "I'd like to help document system A," "I'd like to translate software for my native language," or "I noticed this webapp is particularly slow sometimes and I'd like to help fix that" is perfect. + +Find a mentor or sponsor +------------------------ +This step is both incredibly difficult and important. Finding a proper sponsor will increase your chances of being a successful contributor significantly. Sometimes it's absolutely required. A sponsor will help with training, introductions and teaching new contributors how a team works. + +Most teams have mailing lists. Email the list, say you're looking for a sponsor, and explain what you are wanting to do. If you haven't heard back in a few days, reply saying that you are still looking. ''Keep doing this.'' Most sponsors are people that have been in the project for a long time, and are often very busy. + +They don't mean to be rude and don't want to send the impression they don't want new contributors. It's just that at the moment, some people will assume other people will take care of you and so for the moment, no one does. This is a common problem -- in real life as well as in online communities -- and a difficult one to fix. But sticking to it and continuing to ask for help without being annoying will show that you are serious and ready to contribute. Don't send this kind of message more than once every couple of days, but be positive, and persistent if needed. + +Contributing +------------ +Once you've got something to work on, it's time to actually do work. The first several tasks you will work on will likely be small or maybe mundane. Do them consistently, conscientiously and well. This will raise the level of trust you have from the other team members. + +As with other volunteer organizations, there are high turnover rates in the free software universe. Training volunteers is time consuming, especially for more complex tasks, and requires a commitment from currently busy volunteers. Spending days or weeks training someone only for them to vanish can be disheartening for mentors and sponsors. By giving out small tasks that have been hanging around, a sponsor can help you take small but vital steps, and learn whether or not the work you're going to be doing is really for you. + +Look for work +------------- +If you have access to a repository, system, or content, consider yourself a partial owner. This doesn't mean you should immediately re-design everything. Remember that other owners have time and effort invested in the current material as well. It does mean, though, that you should take pride in the work you are doing. If you see something not quite right, do research on it and notify the list. Seek work out, keep yourself busy and help others. + +Quitting +-------- +If you've found you've over-committed or decide volunteering isn't for you, that's OK. You don't need to be embarrassed that you can't contribute further. Contributors will not make you feel bad about it either. Realize that lots of contributors come and go every day. Being busy with your day job or not having enough free time is a perfectly valid reason for not being able to contribute. It's even possible that you might not feel a good fit with the team or organization. You're entitled to offer help as a volunteer how you want and when you want. + +First and foremost, though, don't just vanish. When a contributor or potential contributor agrees to do work, can't follow through for a valid reason, and vanishes, the team may not know the work can be reassigned. In some cases, people in the team may even worry about the contributor's health or well being. + +When you've decided it's time for you to go or take a break, let your sponsor or the list know and let them know what you were working on. Having people think you are working on something when you aren't slows the team down, and ultimately doesn't benefit you or the team. diff --git a/docs/modules/teams/pages/index12.adoc b/docs/modules/teams/pages/index12.adoc new file mode 100644 index 0000000..521289e --- /dev/null +++ b/docs/modules/teams/pages/index12.adoc @@ -0,0 +1,271 @@ +include::ROOT:partial$attributes.adoc[] + += Fedora Community Operations (CommOps) + +image::commops-logo.png[CommOps logo] + +Community Operations (CommOps) provides tools, resources, and utilities for different sub-projects of Fedora to improve effective communication. +The following areas are examples of where CommOps focuses: + +* Work closely with xref:council::fcaic.adoc[Fedora Community Action and Impact Coordinator] to prioritize key focus areas +* Assist xref:council::fpgm.adoc[Fedora Program Manager] with release preparations +* Support preparation and execution of https://fedoraproject.org/wiki/Elections[Fedora Elections] +* Work with sub-projects and teams to improve on-boarding methods and practices +* Use metrics and data to improve understanding of Fedora community +** Support development of metrics tooling +* And more (detailed below) + +image::infographic-2020.png[Infographic with statistics about Fedora Community Operations. Created by Smera Goel.] + + +[[find-commops]] +== Where to find CommOps + +The CommOps team uses a {DISCOURSE}[Discourse] forum and https://en.wikipedia.org/wiki/Internet_Relay_Chat[IRC] channel to communicate. + +The {DISCOURSE}[Discourse forum] is best for _asynchronous_ communication. +This means it is best for questions or topics that someone may respond to later. +It is better for longer, threaded discussions. + +The CommOps IRC channel on the https://libera.chat/[Libera.chat IRC network] is best for _synchronous_ communication. +This means it is best for quick feedback, like in a conversation. +It is helpful for real-time discussions or getting someone's attention. +Additionally, the CommOps IRC channel is bridged to a Telegram group, if Telegram is more convenient. + +Discourse forum:: {DISCOURSE}[{DISCOURSE}] +IRC channel:: https://libera.chat/[#fedora-commops] on Libera.chat +Telegram group:: https://t.me/fedoracommops[@fedoracommops] on Telegram + +First time using IRC? +Look into https://opensource.com/article/17/5/introducing-riot-IRC[Riot], a free and open source client that connects to various IRC networks. +Riot also keeps you connected to IRC even when you're not connected to the Internet. + + +[[workflow]] +== Workflow + +CommOps uses a ticket-based workflow to keep track of our work. +The repository with tickets is found on https://pagure.io/fedora-commops[pagure.io/fedora-commops]. +Tickets are found under the _https://pagure.io/fedora-commops/issues[Issues]_ menu. + +Various tags are listed at the top of the _Issues_ page. +For good beginner tasks, look at the _https://pagure.io/fedora-commops/issues?status=Open&tags=good+first+issue[good first issue]_ tag. + + +[[meetings]] +== Meetings + +CommOps holds a meeting once a week on IRC to check in on tasks and plan ahead. +Check the https://apps.fedoraproject.org/calendar/commops/[CommOps calendar] for the current date and time. + +Past meeting minutes are recorded in https://meetbot.fedoraproject.org/teams/commops/[Meetbot]. + + +[[meeting-format]] +=== Meeting format + +The upcoming meeting agenda is found on the Fedora https://infinote.fedoraproject.org/cgit/infinote/tree/meeting-templates/fedora-commops-meeting-next[Infinote server]. +Meetings follow an agenda split into five parts: + +. **Roll call**: Waiting for others to arrive, opportunity to introduce yourself and ask general questions +. **Announcements**: Any news or updates to share +. **Action items from last meeting**: Follow-up on `#action` items from previous meeting +. **Tickets**: Discussion and follow-up on tickets https://pagure.io/fedora-commops/issues?status=Open&tags=meeting[marked for meetings] +. **Open floor**: General discussion or comments + + +[[what-commops-does]] +== What CommOps does + +CommOps focuses on a few key areas, both technical and non-technical. + +=== Culture + +The Fedora Project builds and ships a Linux distribution, but there is a community behind the technical work and planning. +In Fedora, we have the xref:project::index.adoc#_what_is_fedora_all_about[Four Foundations] to represent our community culture. +The Fedora community represents a set of ethics and values to how we build our distribution. +These ethics and values create the culture of the Fedora Project. +When working in the community, mindfulness of this culture enriches and supports the different sub-communities inside of Fedora. + +CommOps builds community infrastructure of support and acceptance for the Fedora community's culture. +The _Friends_ foundation is there for a reason. +The community infrastructure CommOps assists with builds on top of the _Friends_ foundation. +People enjoy contributing in a community where they feel valued for who they are and what they bring to the community, not just that they are useful. +CommOps supports this through some of our tasks relating to culture. + +Examples of things we help with to build and support the culture of the Fedora community: + +* https://pagure.io/fedora-commops/issue/17[Interviewing Fedora community members] +* https://pagure.io/fedora-commops/issue/110[Fedora Appreciation Week] +* https://pagure.io/fedora-commops/issue/138[Top Badgers of the Year] + +=== Elections + +There are a few elected bodies in Fedora: the xref:project::leadership.adoc[Fedora Council], xref:mindshare::index.adoc[Mindshare Committee], and xref:fesco::index.adoc[FESCo]. +Every new Fedora release, the community holds elections for these bodies. +Each election takes "wrangling" work to pull it together. +This includes calling for nominations, conducting interviews with candidates, and raising awareness during the voting window. + +CommOps supports the xref:council::fpgm.adoc[Fedora Program Manager] in organizing and executing elections. +These responsibilities consist of curating content on the xref:community-blog.adoc[Community Blog], creating interview templates, and outreach to grow awareness. + +Examples of things we do to help organize and execute Fedora elections: + +* https://pagure.io/fedora-commops/issue/7[Fedora Elections and CommOps Coverage] +* https://pagure.io/fedora-commops/issue/19[Improve automation of Elections communication] +* https://pagure.io/fedora-commops/issue/93[Better explain roles of Council and FESCo] +* https://pagure.io/fedora-commops/issue/107[Automated Fedocal reminders to send to all mailing lists for upcoming Elections] +* https://pagure.io/fedora-commops/issue/112[Create August 2017 election interview templates for candidates] + +=== Storytelling + +Messaging and storytelling bring the Fedora Project "story" to both contributors and user communities. +Every year, a https://mattdm.org/fedora/2018flock/2018-State-of-Fedora.pdf[couple thousand people] work on Fedora. +Messaging is a way of sharing our story in multiple formats. +We bring the message of what we _as a community_ are doing out to others. +Others include our contributors working in other areas of the project and users interested in what the Fedora community produces. +When we share our story with each other, we are aware of other work happening in the Fedora community. +Communicating the story of Fedora keeps our contributors moving together towards our goals. +Good messaging helps our users better understand the goals and objectives of Fedora and how we plan to get there. + +CommOps supports messaging by working with other sub-projects and teams to tell their own stories. +CommOps provides help to "dig out" the stories and tools to share them widely. +This includes tasks like interviews, sharing activities by Fedora contributors, running retrospectives, and more. +These tasks keep contributors in sync with what we're working on. +They are direct actions to keep everyone on the same page. + +Examples of things we do to support messaging and tell stories: + +* https://pagure.io/fedora-commops/issue/4[Interviews about goals for team sprints] +* https://pagure.io/fedora-commops/issue/66[Call for nominations of a Working Group] +* https://pagure.io/fedora-commops/issue/98[Covering upcoming talks by Fedora contributors at a major conference] +* https://pagure.io/fedora-commops/issue/100["Help Wanted" columns] +* https://pagure.io/fedora-commops/issue/129[Year in Review blog series] + +=== Metrics + +CommOps measures community health and engagement through extensive metrics and data available about Fedora. +{FEDMSG}[fedmsg] is a messaging bus with data about activity in the Fedora community. +The data includes activity like git commits, new blog posts, wiki page edits, software build status, IRC meeting notes, and more. +CommOps works with fedmsg to tell stories about our community, but specific types of stories. +The stories told with metrics are helpful to understand what we may be doing right or wrong. +It gives us a data-driven way to understand our huge community. + +CommOps directly supports metrics in Fedora through development time and data-driven storytelling. +Some members develop existing software or build new scripts to analyze data. +Others use the data to write reports or studies on how the Fedora community works. +Ultimately, metrics are a largely technical area that CommOps helps with. + +Examples of metrics work and data-driven storytelling we do: + +* https://pagure.io/fedora-commops/issue/32[Analyzing Fedora contributor activity] +* https://pagure.io/fedora-commops/issue/88[Fedora release party metrics] +* https://pagure.io/fedora-commops/issue/109[Understanding contributor activity by geographic location] + +=== Supporting sub-projects + +CommOps assists other sub-projects and teams in following best practices and communicating effectively. +We work with other teams to help them on-board new contributors into their teams. +This includes creating Fedora Badge requests, reviewing guidelines, and making Fedora services and tools more understandable. + +Examples of sub-project support and on-boarding work: + +* https://pagure.io/fedora-commops/issue/62[Wiki gardening of Fedora Join] +* https://pagure.io/fedora-commops/issue/69[Fedora Modularity onboarding] +* https://pagure.io/fedora-commops/issue/76[Update Onboarding Calendar for GSoC 2016] +* https://pagure.io/fedora-commops/issue/95[Onboarding: DotNet SIG] + + +[[join-commops]] +== Join CommOps + +Read our guide on xref:contribute/join.adoc[how to join the CommOps team]. + +CommOps always welcomes new contributors. +Whether you are a newcomer or an old-timer, there are ways to get involved. +Join CommOps to: + +* Build your portfolio in open source community management +* Directly see the impact of your contributions over time +* Gain a holistic view of the Fedora Project and learn how the pieces fit together +* Work directly with Fedora Project leadership +* Work with teammates from around the world +* Aspire to the greatness of a community superheroine or superhero + +.Join the CommOps team today +[link="contribute/join/"] +image::https://fedoraproject.org/w/uploads/7/72/Happypanda.png[Happy Panda,100] + + +[[toolbox]] +== Toolbox + +The CommOps toolbox explains tools and services often used by the team. +The tools are organized by purpose and use. + +[[communication-tools]] +=== Communication tools + +These are communication tools to share content and information with others in the Fedora community. + +xref:community-blog.adoc[Community Blog] (CommBlog) - https://communityblog.fedoraproject.org/[communityblog.fedoraproject.org]:: +Centralized blog for contributors to publish news, activities, or calls for help to the rest of the project. +Useful place for getting an inside scoop on "what's happening" in Fedora. + +https://infrastructure.fedoraproject.org/cgit/ansible.git/tree/roles/fedmsg/irc/templates/ircbot.py?id=0279643#n77[ircbot.py]:: +Python script for fedmsg notifications in https://libera.chat/[#fedora-commops]. +Relays real-time updates and changes relating to CommOps in our IRC channel. + + +[[metrics-tools]] +=== Metrics tools + +These tools access and use the Fedora messaging bus, {FEDMSG}[**fedmsg**]. +With these tools, you can generate metrics, analyze data, and interact with fedmsg. + +https://github.com/fedora-infra/fedora-stats-tools/blob/develop/annualgrepper.py[annualgrepper]:: +Gather raw fedmsg totals on https://fedora-fedmsg.readthedocs.io/en/latest/topics.html[topics] in the last year + +https://pagure.io/cardsite[cardsite]:: +Live fedmsg tracker inspired by http://emojitracker.com/[emojitracker] + +https://github.com/fedora-infra/fedora-stats-tools/blob/develop/daily-briefing.py[daily-briefing.py]:: +Template that takes lists of URLs, generates summary reports of daily Meetbot links and action items (manual now, can be automated!) + +https://apps.fedoraproject.org/datagrepper/[datagrepper]:: +The powerhouse tool to interact with fedmsg. +Using HTTP GET requests, query for historical data from fedmsg. +Examples include events by username, by package, by message source, and more. + +{FEDMSG}[fedmsg]:: +Python package and API that hooks into various Fedora Infrastructure services. +Sends messages from each service to a unified message bus in real-time. +fedmsg drives and powers all the metrics tools we have. + +https://github.com/fedora-infra/fedora-stats-tools[fedora-stats-tools]:: +Multiple statistics tools, data, and slide decks for fedmsg metrics, Year in Reviews, and Fedora event metrics + +https://pagure.io/feedcloud[feedcloud]:: +Takes an RSS feed or list of RSS feeds and generates fancy word-clouds for them + +https://pagure.io/gsoc-stats[gsoc-stats]:: +Python tool to generate statistics about Fedora contributors + +https://github.com/fedora-infra/fedora-stats-tools/blob/develop/longtail-analyze.py[longtail-analyze.py], https://github.com/fedora-infra/fedora-stats-tools/blob/develop/longtail-gather.py[longtail-gather.py]:: +Measure the ratio of activity per user to approximate burnout + +https://github.com/fedora-infra/fedora-stats-tools/blob/develop/meetbot-fedmsg-activity.py[meetbot-fedmsg-activity.py]:: +Jinja2 template that creates links to Meetbot activities + +https://pagure.io/wordcloudbot[wordcloudbot]:: +Create pretty wordclouds from IRC meeting logs + + +[[other]] +=== Other + +Other tools that don't belong elsewhere fit under here. + +https://github.com/OSAS/rh-events[OSAS/rh-events]:: +Data for Red Hat conference and talk attendance. +Useful for plotting events in our own calendar and keeping track of what's happening in the open source community. diff --git a/docs/modules/teams/pages/irc-group-contact.adoc b/docs/modules/teams/pages/irc-group-contact.adoc new file mode 100644 index 0000000..9ca3123 --- /dev/null +++ b/docs/modules/teams/pages/irc-group-contact.adoc @@ -0,0 +1,37 @@ +include::ROOT:partial$attributes.adoc[] + += IRC / Libera Chat Group Contacts + +libera.chat IRC network has a concept of ‘Groups’ for various projects. Group contacts for each of those groups are granted special powers on the network over their groups channels. Additionally, requests from Group contacts can be taken as ‘official’ requests from the group. Fedora group contacts represent Fedora to libera.chat. + +The primary functions of group contacts are: + +* Check/process ‘cloak’ requests and request them from libera.chat admins to process. (Cloaks are a hostmask with the project name in them instead of hostname or ip address. It’s a way to note your affiliation with a group) +* To (re)gain and configure control of irc channels in the group namespace “#fedora*” + + +== How to join the team / step down + + +Group contacts are added from very trusted project members and kept to a small number. Council should appove changes in libera.chat group members. Changes will then be made by libera admins to joining / leaving accounts. + +== Responsibilities + +* Process the ‘cloaks’ requests: https://fedoraproject.org/wiki/LiberaCloaks as time permits. +* Process requests in the https://pagure.io/irc tracker for matrix bridges or regaining control of a channel in the #fedora* namespace as requested. +* Idle in the #libera-communities channel to make requests to libera admins as needed. + +== Teams you will be working closely with + +* libera.chat admins in #libera.communities +* Any fedora groups needing irc work + +== Current members + +** Tom Calloway / spot +** Nick Bebout / nb +** Kevin Fenzi / nirik + +== Contact information + +Link : https://pagure.io/irc