From 805474d9bd14d2cc5237219cb518ab33ca8eb636 Mon Sep 17 00:00:00 2001 From: Brian (bex) Exelbierd Date: Jul 29 2018 12:04:21 +0000 Subject: Adding mindshare docs to this repo --- diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..9f3ebf5 --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +build +cache +public diff --git a/build.sh b/build.sh new file mode 100755 index 0000000..c9349e3 --- /dev/null +++ b/build.sh @@ -0,0 +1,16 @@ +#!/bin/sh + +if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + docker run --rm -it -v $(pwd):/antora antora/antora --html-url-extension-style=indexify site.yml + +elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Let's assume that it's running the Docker deamon + # which requires root. + echo "" + echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it." +sudo docker run --rm -it -v $(pwd):/antora:z antora/antora --html-url-extension-style=indexify site.yml +fi diff --git a/preview.sh b/preview.sh new file mode 100755 index 0000000..acab783 --- /dev/null +++ b/preview.sh @@ -0,0 +1,18 @@ +#!/bin/sh + +if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + echo "The preview will be available at http://localhost:8080/" + docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx + +elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Let's assume that it's running the Docker deamon + # which requires root. + echo "" + echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it." + echo "The preview will be available at http://localhost:8080/" + sudo docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx +fi diff --git a/site.yml b/site.yml new file mode 100644 index 0000000..0c5bcf4 --- /dev/null +++ b/site.yml @@ -0,0 +1,21 @@ +site: + title: Mindshare Local Preview + start_page: mindshare::index +content: + sources: + - url: . + branches: HEAD + start_path: website +ui: + bundle: + url: https://asamalik.fedorapeople.org/ui-bundle.zip + snapshot: true + default_layout: with_menu +output: + clean: true + dir: ./public + destinations: + - provider: archive +runtime: + pull: true + cache_dir: ./cache diff --git a/website/antora.yml b/website/antora.yml new file mode 100644 index 0000000..96cd004 --- /dev/null +++ b/website/antora.yml @@ -0,0 +1,16 @@ +# Name will be mostly visible in the URL. Treat it as an indentifier. +# Tip: If you want to use the local preview scripts that come with this repository, please change this value in the site.yml file as well. (under site/start_page) +name: mindshare + +# Title will be visible on the page. +title: Fedora Mindshare + +# If you don't plan to have multiple versions of the docs (for example, to document multiple versions of some software), you can ignore this field. Otherwise, change "master" to a specific version. +version: master + +# We encourage you to name the index page as "index.adoc". If you absolutely have to use a different name, please reflect it here. You can ignore this field otherwise. +start_page: ROOT:index + +# This lists all the menu definitions of your component. +nav: +- modules/ROOT/nav.adoc diff --git a/website/modules/ROOT/assets/images/Screenshot_from_2017-09-22_23-33-02.png b/website/modules/ROOT/assets/images/Screenshot_from_2017-09-22_23-33-02.png new file mode 100644 index 0000000..04722cf Binary files /dev/null and b/website/modules/ROOT/assets/images/Screenshot_from_2017-09-22_23-33-02.png differ diff --git a/website/modules/ROOT/nav.adoc b/website/modules/ROOT/nav.adoc new file mode 100644 index 0000000..bf0a0a1 --- /dev/null +++ b/website/modules/ROOT/nav.adoc @@ -0,0 +1 @@ +* xref:teams.adoc[Mindshare Teams] diff --git a/website/modules/ROOT/pages/index.adoc b/website/modules/ROOT/pages/index.adoc new file mode 100644 index 0000000..7bd1b8d --- /dev/null +++ b/website/modules/ROOT/pages/index.adoc @@ -0,0 +1,88 @@ += Mindshare + +The Fedora Mindshare Committee represents the outreach leadership in Fedora. Mindshare aims to help outreach teams to reach their targets in a more effective way, by unifying and sharing their working process through an optimized and standardized communication. It consists of mostly appointed, but also elected members. + +== Responsibilities + +Mindshare takes care of some responsibilities hold actually by other teams, adding some more strategical responsibilities to make sure communication and sharing of ideas, actions and projects can be guaranteed. These include: + +* Communication between teams (outreach teams rely on the work of other groups). Mindshare ensures all information from technical teams will get out in time to all outreach teams, working out also a common strategy with Marketing of how to communicate them outside and how to manage them within all outreach teams. +* Ambassadors activity: Mindshare will create templates to help ambassadors to work more effectively. Not only by providing report templates, but also by asking them once a year to compile a short survey. This can help to get real information whether an ambassador is active or not and will not result too binding. +* Motivate contributors to work also in other groups, providing easier access to funding and more autonomy. This challenging part will need some verifying tools (TBD) +* Mindshare takes over all decisional responsibilities left on FAmSCo. Administrative responsibilities will be handled by FAmA, which will consist mainly by treasurers and FAmA admins. +* CommOps which is part of Mindshare takes care of the operations inside Fedora. CommOps will lead the communication between technical and outreach teams. +* Sharing best practices: one of the Mindshare's goals is to take down barriers or whatever is blocking sharing best practices. All teams and all regions can learn from each other and apply successful practices to their local community. +* Mindshare will also try to unify ambassadors more and more, also by dropping the actual Regions. They are not helping communication and were created mostly for organizational aspects. FAmA (with treasurers) will help to sort out regional aspects and meetings, but having a unique ambassadors group will help in several ways to be more effective again. +* Budget: Without regions also the (ex-)regional budgeting process changes. Mindshare will, in collaboration with the FCAIC and consequently with the Council, take care of the Fedora outreach budget (sum of the 4 regional budgets). Minor funding requests can be handled directly by FAmA and treasurers, more important expenses will go through Mindshare, in order to be able and track even necessary reports the Council needs. +* Marketing as part of Mindshare will drive the other teams by providing messages, strategies and talking points for ambassadors. A good collaboration with the other teams is necessary. + +== Making Decisions + +Many basic decisions are made through a process known as *"lazy approval"*, in which general consent is assumed unless valid objections are raised within a period of time — generally three to seven days, although the timeframe should be stated each time and should be proportionate to the impact of the action. This process is used for decisions with short-term consequences and which can be easily reversed. Any project member can ask for the deadline to be extended or the decision escalated to require full consensus. + +More significant decisions are made through a process of *full consensus*. In order to pass, these decisions need three positive votes (+3) and no negative votes (-1). A negative vote immediately halts the process and requires discussion. Therefore, in order to remain valid, negative votes must be supported with a specific concerns about the poposal, and suggestions for what could be changed in order to make the proposal acceptable. A vote of "0" is sometimes used to indicate a disagreement but willingness to stand aside; this should also be accompanied with an explanation. + +This model matches Fedora's "Friends" foundation, which calls for finding acceptable consensus to serve the interests of advancing free software. It works because we work together in a community of mutual respect even when we disagree. + +In general, Mindsharel conducts business in public discussion, and any Fedora project member can add more opinions and thoughts. It is the duty of the Mindshare Committee to take concerns raised in this way into serious consideration, but only Mindshare members' votes are binding in the final tally. + +== Composition + +image::Screenshot_from_2017-09-22_23-33-02.png[Mindshare Structure,100%,] + +Mindshare has appointed and elected members, and initially there will be 9 seats: + +* FCAIC (chair) +* Ambassadors (2 appointed members) +* Design & Web (appointed) +* Docs (appointed) +* Marketing (appointed) +* Commops (appointed) +* 2 elected seats + +*Note:* The minimum of elected representatives is 2; 3 representatives are elected when the number of seats would otherwise be even. + +== Current Members + +* Elected Representative: *Jared Smith* (https://fedoraproject.org/wiki/User:Jsmith[jsmith]) (_f27-f28_) +* Elected Representative: *Sumantro Mukherjee* (https://fedoraproject.org/wiki/User:Sumantrom[sumantrom])(_f28-f29_) +* FCAIC: *Brian Exelbierd* (https://fedoraproject.org/wiki/User:Bex[bex]) +* Ambassador Representative: FAmA *Robert Mayr* (https://fedoraproject.org/wiki/User:Robyduck[robyduck]) - _ad interim_ +* Ambassador Representative: FAmA *Nick Bebout* (https://fedoraproject.org/wiki/User:Nb[nb]) - _ad interim_ +* Marketing Representative: *Eduard Lucena* (https://fedoraproject.org/wiki/User:X3mboy[x3mboy]) +* CommOps Representative: *Justin W. Flory* (https://fedoraproject.org/wiki/User:Jflory7[jflory7]) +* Design & Web Representative: *Maria Leonova* (https://fedoraproject.org/wiki/User:Mleonova[mleonova]) +* Docs Representative: *Brian Exelbierd* (https://fedoraproject.org/wiki/User:Bex[bex]) - _ad interim_ + +== Contact Info + +=== Mailing lists + +The Mindshare Committee uses two mailing lists: a regular discussion list and an announcement-only mailing list. + +*https://lists.fedoraproject.org/admin/lists/mindshare@lists.fedoraproject.org/[mindshare]* is a public discussion list. +This is the main discussion point for the Mindshare Committee. +The goal of the list is to either reach a decision or delegate a thread to a more appropriate location. + +*https://lists.fedoraproject.org/admin/lists/mindshare-announce@lists.fedoraproject.org/[mindshare-announce]* is a low-traffic, announcement-only mailing list. +This list is used for occasional updates, news, and announcements from the Committee. +Posting privileges are limited to Mindshare Committee members. +Consider subscribing to this list if you want to stay informed about ongoing activities within the Mindshare Committee. + +== IRC / Telegram + +Mindshare Committee members are present in the *#fedora-mindshare* IRC channel on the Freenode IRC network. +This IRC channel is also bridged to a Telegram group for convenience. +Messages are synchronized between the two. +Telegram users can join https://t.me/fedoramindshare[here]. + +== Pagure == + +The Mindshare Committee operates in a ticket-based workflow. +If you have an issue or task for the Mindshare Committee, open a ticket on the https://pagure.io/mindshare/issues[Pagure instance]. +This is a public issue tracker. +If you have a privacy- or security-sensitive issue, check the _Private_ box when creating the ticket. + +== Meetings + +The Fedora Mindshare Committee does hold regular public IRC meetings to discuss current issues, to clear through anything outstanding which can be quickly resolved, and to ensure that nothing important is left in limbo. All members are be expected to regularly communicate what's going on in their area, through blog posts or other public updates. diff --git a/website/modules/ROOT/pages/teams.adoc b/website/modules/ROOT/pages/teams.adoc new file mode 100644 index 0000000..6b2fc9e --- /dev/null +++ b/website/modules/ROOT/pages/teams.adoc @@ -0,0 +1,3 @@ += Outreach Teams in Fedora + +* xref:commops:ROOT:index.adoc[**Fedora Community Operations (CommOps)**] — Community Operations (CommOps) provides tools, resources, and utilities for different sub-projects of Fedora to improve effective communication. \ No newline at end of file