asamalik / fedora-commops

Forked from fedora-commops 5 years ago
Clone
README.md

Community + Operations = CommOps

Community Operations, a.k.a. CommOps, addresss community infrastructure by providing tools, resources, and utilities for different sub-projects to improve communication across Fedora

What can I do here?

File a ticket to:

  • Share information in one area of the Project with the rest
  • Requesting metrics about an area of the Project
  • More coming soon…

You can also help us out too! Take a look at the active issue list and look for an issue assigned with a blank assignment, and feel free to take that task yourself. If there aren't any open issues, ask on our mailing list where you can help out.

Because this is mainly a volunteer-staffed team, we may not notice all new issues immediately when they are filed. If you think an issue needs attention, try to contact the owner and see if they are working on it. If you don't hear from them within a week, you can probably take over the task.

If you want to carry on a longer conversation with the team, you may want to join our ​mailing list.

IRC

  • #fedora-commops on Freenode (webchat)

Mailing Lists

Things we help with

Specific details of each of these areas is found on our wiki page.

  • Unified messaging
  • Curating a queue of "stories"
  • Badges Requests
  • New Contributor Onboarding via Fedora Hubs
  • Wiki
  • Internal Communications
  • Code of Conduct and Diversity
  • Metrics
  • Voter Turnout
  • Release Notes

CommOps Documentation

Please report Issues and submit Pull Requests for Content Fixes here. Never done a pull request (or "PR")? Here's the Pagure documentation for Pull Requests.

General appearance issues and publishing issues should be reported against the publishing software.

How to edit these documents

All of this is written in AsciiDoc. It's a simple mostly-plain-text markup language. You may want to look at:

Local preview

This repo includes scripts to build and preview the contents of this repository.

NOTE: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see the Fedora Docs build repository for instructions.

Both scripts use docker, so please make sure you have it installed on your system. Please see below for instructions.

To build and preview the site, run:

$ ./build.sh && ./preview.sh

The result will be available at http://localhost:8080

Installing docker on Fedora

$ sudo dnf install docker
$ sudo systemctl start docker && sudo systemctl enable docker