#146 Update CommOps overview for 2018
Merged 2 years ago by jflory7. Opened 2 years ago by jflory7.

file modified
+1 -1

@@ -7,5 +7,5 @@ 

    site_url: https://docs.fedoraproject.org/

    branches:

      master:

-       name: Rawhide
bex commented 2 years ago

This change may break the local repo index.html. It has no effect on final publishing.

+       name: " "

        dir: master

file modified
+1 -1

@@ -21,7 +21,7 @@ 

  # The ordering of the records in this document determines the ordering of the

  # topic groups and topics on the main page.

  ---

- Name:  Fedora Community Operations (CommOps)

+ Name:  Community Operations (CommOps)

  Dir: docs

  Topics:

    - Name: About CommOps

file modified
+2

@@ -1,2 +1,4 @@ 

+ :COMMBLOG: https://communityblog.fedoraproject.org

+ :FEDMSG: http://www.fedmsg.com/

  :FWIKI: https://fedoraproject.org/wiki

  :YEAR: 2018

file added
+277

@@ -0,0 +1,277 @@ 

+ include::docs/attributes.adoc[]

+ 

+ = Fedora Community Operations (CommOps)

+ 

+ image::docs/_static/img/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 https://docs.fedoraproject.org/fedora-project/council/fcaic.html[Fedora Community Action and Impact Coordinator] to prioritize key focus areas

+ * Assist https://docs.fedoraproject.org/fedora-project/council/fpgm.html[Fedora Program Manager] with release preparations

+ * Support preparation and execution of 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 fully below)

+ 

+ 

+ [[find-commops]]

+ == Where to find CommOps

+ 

+ The CommOps team uses a mailing list and https://en.wikipedia.org/wiki/Internet_Relay_Chat[IRC] channel to communicate.

+ The mailing list is best for _asynchronous_ communication.

+ The CommOps IRC channel on the https://freenode.net/[Freenode IRC network] is best for _synchronous_ communication.

+ 

+ Mailing list:: commops [at] lists [dot] fedoraproject [dot] org (https://lists.fedoraproject.org/admin/lists/commops.lists.fedoraproject.org/[subscribe here])

+ IRC channel:: irc://irc.freenode.net/#fedora-commops[#fedora-commops] on Freenode

+ 

+ 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 on https://pagure.io/[Pagure].

+ The repository is named https://pagure.io/fedora-commops[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 holda a meeting once a week on IRC to check in our 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 https://docs.fedoraproject.org/fedora-project/project/fedora-overview.html#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 culture of the Fedora community.

+ 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, such as the https://docs.fedoraproject.org/fedora-project/council/charter.html[Fedora Council], https://docs.fedoraproject.org/fedora-project/subprojects/mindshare/mindshare.html[Mindshare Committee], and https://docs.fedoraproject.org/fedora-project/subprojects/fesco/fesco.html[FESCo].

+ Every new Fedora release, the community holds elections for these bodies.

+ Each election takes "wrangling" work to pull together.

+ This includes calling for nominations, conducting interviews with candidates, and raising awareness during the voting window.

+ 

+ CommOps supports the https://docs.fedoraproject.org/fedora-project/council/fpgm.html[Fedora Program Manager] in organizing and executing elections.

+ These responsibilities consist of curating content on the https://docs.fedoraproject.org/fedora-project/subprojects/mindshare/docs/community-blog.html[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 "story" of the Fedora Project to both the contributor and user community.

+ Every year, a https://mattdm.org/fedora/2018devconf/DevConfcz2018Charts.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 the help to "dig out" the stories and the 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

+ 

+ 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 working on real-world projects

+ * Gain 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 superhero

+ 

+ .Join the CommOps team today

+ [link="contribute/join.html"]

+ 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 their purpose and use.

+ 

+ [[communication-tools]]

+ === Communication tools

+ 

+ These tools are for communicating to others in the Fedora community.

+ 

+ https://docs.fedoraproject.org/fedora-project/subprojects/mindshare/docs/community-blog.html[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.

+ 

+ ircbot.py::

+ https://infrastructure.fedoraproject.org/cgit/ansible.git/tree/roles/fedmsg/irc/templates/ircbot.py?id=0279643#n77[Python script] for fedmsg notifications in irc://chat.freenode.net/#fedora-commops[#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**.

+ With these tools, you can generate metrics, analyze data, and interact with fedmsg.

+ 

+ annualgrepper::

+ https://github.com/fedora-infra/fedora-stats-tools/blob/develop/annualgrepper.py[annualgrepper.py]

+ Gather raw fedmsg totals on https://fedora-fedmsg.readthedocs.io/en/latest/topics.html[topics] in the last year

+ 

+ cardsite::

+ https://pagure.io/cardsite[pagure.io/cardsite]

+ Live fedmsg tracker inspired by http://emojitracker.com/[emojitracker]

+ 

+ daily-briefing::

+ 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!)

+ 

+ datagrepper::

+ https://apps.fedoraproject.org/datagrepper/[apps.fedoraproject.org/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::

+ http://fedmsg.com[fedmsg.com]

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

+ 

+ fedora-stats-tools::

+ https://github.com/fedora-infra/fedora-stats-tools[github.com/fedora-infra/fedora-stats-tools]

+ Multiple statistics tools, data, and slide decks for fedmsg metrics, Year in Reviews, and Fedora event metrics

+ 

+ feedcloud::

+ https://pagure.io/feedcloud[pagure.io/feedcloud]

+ Takes an RSS feed or list of RSS feeds and generates fancy word-clouds for them

+ 

+ gsoc-stats::

+ https://pagure.io/gsoc-stats[pagure.io/gsoc-stats]

+ Python tool to generate statistics about Fedora contributors

+ 

+ longtail::

+ 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

+ 

+ meetbot-fedmsg-activity::

+ 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

+ 

+ statscache::

+ https://github.com/fedora-infra/statscache[github.com/fedora-infra/statscache]

+ Daemon to build and keep highly-available fedmsg statistics

+ 

+ wordcloudbot::

+ https://pagure.io/wordcloudbot[pagure.io/wordcloudbot]

+ Create pretty wordclouds from IRC meeting logs

+ 

+ 

+ [[other]]

+ === Other

+ 

+ Other tools that don't belong elsewhere fit under here.

+ 

+ OSAS/rh-events::

+ https://github.com/OSAS/rh-events[github.com/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.

Preview this PR


Summary

Updates the CommOps overview to be more accurate about what we do, explain our tasks, and how to get involved with the team

Background

This was started at the CommOps FAD and mostly finished at the Docs FAD.

On one hand, it moves us away from the wiki and keeps our sub-project info in Fedora Docs. The source files all live in this repo.

On the other hand, it's actually a major content change. I completely rewrote the page and tried to give more concrete examples of the things we do.

Details

The content changes need a review. Most of the heaviest lifting was to the What CommOps does section. It's divided into five main pieces:

  • Culture
  • Elections
  • Messaging and storytelling
  • Metrics
  • Supporting sub-projects

Action

Core team members, please review the updated content and share any feedback on changes or improvements.

After, we can get it published with help from @bex and deprecate our wiki page.

the content is fine for me, i love the culture section ( It is even clearer to me now ) and it will be excellent to explain to the people who wish to enter the group our activities.

it's very useful have tickets as examples of our activities.

+1 for this PR

We should consider differentiating this more from the work of fedora-infrastructure. I actually this could be done by just deleting this line. I think the second sentence is a better intro.

Not in this PR, but it would be great to get a piece written on the difference in asynch and sync and what each is generally better at.

assists with, builds

insert comma?

This displays funny in the preview as "Join the commOps team today" twice in a row.

This change may break the local repo index.html. It has no effect on final publishing.

This PR needs to include an update to _topic_map.yml to uncomment this page's entry.

What about "not connected to the internet" instead of "not at the keyboard"?

move to previous paragraph

The Friends foundation is there for a reason.

If messaging is a form of storytelling, shouldn't this section be called, storytelling?

What about:

Messaging is a way of sharing our story in multiple formats.

s/message/story/; s/mindful/aware/

s/marching in step/moving/

s/Our/Good messaging helps our/

We should probably work in the word "gobby" here somewhere and include a link to the page on how to use it.

1 new commit added

2 years ago

I addressed most of @bex's feedback in commit 75c1b08. The only thing I passed on was adding a note about Gobby and how we use it, since I think it's out of scope for this document. I implemented everything else.

The feedback deadline has passed, so I am going to merge this PR. I will sync up with @bex on generating a new version of the documentation site to include this page.

Pull-Request has been merged by jflory7

2 years ago