Fix Vale and layout issues, create missing link files

mautic · Oct 22, 2024 · 1a580b0 · 1a580b0
1 parent 5ff0dba
commit 1a580b0
Show file tree

Hide file tree

Showing 12 changed files with 243 additions and 0 deletions.
diff --git a/docs/links/code_of_conduct.py b/docs/links/code_of_conduct.py
@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "CoC" 
+link_text = "Code of Conduct" 
+link_url = "https://www.mautic.org/code-of-conduct" 
+
+link.xref_links.update({link_name: (link_text, link_url)})
diff --git a/docs/links/community_portal.py b/docs/links/community_portal.py
@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "Community Portal" 
+link_text = "Community Portal" 
+link_url = "https://community.mautic.org" 
+
+link.xref_links.update({link_name: (link_text, link_url)})
diff --git a/docs/links/community_team_slack.py b/docs/links/community_team_slack.py
@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "Community Team Slack" 
+link_text = "#t-community" 
+link_url = "https://mautic.slack.com/archives/CQV40ULMA" 
+
+link.xref_links.update({link_name: (link_text, link_url)})
diff --git a/docs/links/international_country_forums.py b/docs/links/international_country_forums.py
@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "International Forums" 
+link_text = "International - By Country" 
+link_url = "https://forum.mautic.org/c/international-by-country" 
+
+link.xref_links.update({link_name: (link_text, link_url)})
diff --git a/docs/links/mautic_meetups_forum.py b/docs/links/mautic_meetups_forum.py
@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "Meetups Forum Category" 
+link_text = "Mautic Meetups category" 
+link_url = "https://forum.mautic.org/c/mautic-meetups/7" 
+
+link.xref_links.update({link_name: (link_text, link_url)})
diff --git a/docs/links/mauticon_slack.py b/docs/links/mauticon_slack.py
@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "Mauticon Slack" 
+link_text = "#mauticon" 
+link_url = "https://mautic.slack.com/archives/CA7RCS7SA" 
+
+link.xref_links.update({link_name: (link_text, link_url)})
diff --git a/docs/links/partners_directory.py b/docs/links/partners_directory.py
@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "Partners' Directory" 
+link_text = "Partners' Directory" 
+link_url = "https://www.mautic.org/mautic-community-partners" 
+
+link.xref_links.update({link_name: (link_text, link_url)})
diff --git a/docs/links/savannah_crm.py b/docs/links/savannah_crm.py
@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "Savannah CRM" 
+link_text = "Savannah CRM" 
+link_url = "https://www.savannahhq.com/" 
+
+link.xref_links.update({link_name: (link_text, link_url)})
diff --git a/docs/links/savannah_dashboard.py b/docs/links/savannah_dashboard.py
@@ -0,0 +1,7 @@
+from . import link
+
+link_name = "Savannah Dashboard" 
+link_text = "publicly shared dashboard" 
+link_url = "https://savannahcrm.com/public/overview/2b4590bf-cad0-4c71-870a-6f942a25f8fe/" 
+
+link.xref_links.update({link_name: (link_text, link_url)})
diff --git a/docs/teams/community_team/community_dashboard.rst b/docs/teams/community_team/community_dashboard.rst
@@ -0,0 +1,17 @@
+Community dashboard
+###################
+
+The Community Dashboard uses the open-source :xref:`Savannah CRM` tool to import, analyze and visualize data from multiple sources in one central location.
+
+You can view the data from the last 90 days on the :xref:`Savannah Dashboard`.
+
+Currently the dashboad imports:
+
+-  All repositories listed under github.com/mautic
+-  Specified channels from mautic.slack.com
+-  All threads on forums.mautic.org
+-  All threads on reddit.com/r/mautic
+-  All Stack Overflow posts tagged with Mautic
+-  Specified meetup.com groups (coming soon)
+
+The information is used to determine the activity levels of individuals and organizaitons within the community, which informs the monthly updates in Slack and the ranking of organizations in the :xref:`Partners' Directory`.
diff --git a/docs/teams/community_team/community_team.rst b/docs/teams/community_team/community_team.rst
@@ -0,0 +1,86 @@
+Community Team
+##############
+
+Mission and expectations
+************************
+
+   We want more and more people to feel at home in the Mautic community.
+   And we want to inspire & enable them to contribute to our cause.
+
+General Community Team tasks
+****************************
+
+-  Support growth of the global as well as the local communities
+-  Help the Mautic community be most ethical, accessible and inclusive
+-  Provide really easy starting points for contribution
+-  Organize and support Mautic events
+-  Continue to improve community infrastructure
+-  Connect with other Open Source communities
+
+Sample activities for the Community Team
+****************************************
+
+General activities of the Community Team
+========================================
+
+-  Keep rethinking community and contribution structures
+-  Improve global community infrastructure, rearrange forums, etc
+-  Define & refine official event formats
+-  Help people to organize and promote local Mautic events
+
+But also
+
+-  Understand community personas
+-  Promote and help building a business on Mautic, and explain active
+   contribution as an important element of it
+-  Find, grow and support ambassadors
+-  Connect & collaborate with other communities
+-  Support fundraising initiatives
+
+Global Communities
+==================
+
+-  Make global community more accessible, give transparency on
+   tasks/actors/processes, and provide easy starting points
+-  Reach out to previously active contributors, try to reactivate them
+   Including: WHAT is the message? WHAT are the channels?
+-  Reach out to existing passive community members, try to activate them
+-  Organize global events
+-  Develop an easy path from local community to global contribution
+
+Local Communities
+=================
+
+-  Know and work with all local communities (even Facebook/LinkedIn groups etc.)
+-  Define and support official ways for building local communities (and steer existing ones to becoming official, plus inspire new ones) , help them to network and learn from each other
+-  Web page that identifies official local communities, and where to find them
+-  Help local events (material, speakers, tools, best practices, ...)
+-  Identify per-region “liaisons”, especially in countries where Mautic is not known (not the same as ambassadors!), and establish ways of working with them, without potential others from the region being demotivated or shied away.
+-  Select priority regions and work actively to spark local communities there
+
+Profiles of contributors needed in the Community Team
+*****************************************************
+
+-  Everyone who is enthusiastic enough
+-  As ambassadors: People in different countries who are already well-connected through other activities, and have a broad understanding of Mautic's facets (both from the user's and from the MarTech and even dev side, but no actual dev knowledge required)
+-  Define what we call people who start or lead a community in a certain
+   country
+
+Community Team definitions
+**************************
+
+Who is Community member?
+
+Everyone who
+
+-  Contributed code or content to Mautic
+-  Visited a website to ask for Mautic support
+-  Is interested in Mautic, even without ever contributing!
+
+What is contribution?
+
+-  All contributions are important for the success of the project, since contributions by newcomers might lead to happy and dedicated core contributors.
+-  This includes mentions like “It doesn't work on my server” which too is a valuable contribution - the underlying message being for example “improve documentation”.
+-  Even failed contributions are essential, because of how much we can learn when we fail. Contribution from newcomers is especially valuable, because they see the project with fresh eyes.
+
+**Would you like to be involved in this team? Join :xref:`Community Team Slack` on Slack!**
diff --git a/docs/teams/community_team/meetup_guidelines.rst b/docs/teams/community_team/meetup_guidelines.rst
@@ -0,0 +1,77 @@
+Guidance for establishing official Mautic Meetups, Groups & Events
+##################################################################
+
+The Community Team agreed on 12th December 2019 the following guidelines
+for establishing official Mautic groups within the Community.
+
+All meetups, groups and events agree to abide by the Mautic :xref:`CoC` at all times.
+
+Mautic Meetups
+**************
+
+These are the traditional kind of in-person meetups which are based in a
+region or a town. They are **not** to be created on a country-wide
+basis.
+
+General guidelines for official Mautic Meetups
+**********************************************
+
+1. Mautic Meetups are for the benefit of the Mautic community as a whole, not specific businesses or individuals.
+2. All actions taken as an event organizer are with the best interest of the community in mind.
+3. Membership in the local meetup group is open to all who wish to join, regardless of ability, skill, financial status or any other criteria.
+4. Meetups are volunteer-run with volunteer speakers. In cases where a modest attendance fee might be necessary, this fee should only cover the costs of the meetup and should not be used to pay speakers or organizers.
+5. Meetup groups allow events to be organized by any reliable/trusted member of the community.
+6. Meetups are welcoming places where everyone works to foster an accepting environment which is free of discrimination, incitement to violence, promotion of hate, and general jerk-like behavior.
+
+Official groups will have a Meetup group created on the :xref:`Community Portal` and a category created in :xref:`Meetups Forum Category` on the forums once the following criteria are met: 
+
+1. A thread on the Mautic Community Forums in the :xref:`International Forums` category indicating at least two people interested in joining the meetup
+2. A clear region or town for the meetup to be based in, not covered by an existing meetup
+3. Two group organisers identified from within the Mautic community, preferably not from the same company
+4. A location confirmed for meeting which is an office or community space (i.e. not a bar/pub)
+5. A date for the launch event (ideally at least four weeks ahead to give time for organising, promoting and getting people to attend)
+6. A proposed time and day each month (e.g. from 6pm on the first Friday of each month) for regular events
+
+These events (commonly referred to as “meetups”, which can be confusing since people often use the same word to describe the group itself) might take many formats:
+
+-  presentations/lecture series
+-  hackathons
+-  social gatherings
+-  workshops
+-  co-working
+-  a session to help people with Mautic
+-  contributor sprints/drives, and others.
+
+Existing groups can be brought into the official Mautic Meetup account by contacting the Project Lead. This will mean that the meetup.com fees will be covered by the Mautic Community.
+
+Official Mautic Meetup groups are also eligible for sponsorship by Community Partners - for example to cover the cost of food for a sprint event or to bring in a speaker who needs travel or accommodation.
+
+Mautic Meetups Online
+*********************
+
+These are an online variation of the traditional meetup. There are no restrictions on region, and they can span any geographic area.
+
+These meetups will not have a Meetup group (as these must be physical meetups) however they will have a category created in the Mautic Meetups category on the forums through which members can find information and discuss any relevant issues.
+
+Official online Mautic Meetups agree to the same general guidelines as physical meetups (see above).
+
+We currently provide an airmeet.com account to run meetups online for up to 100 attendees.
+
+MautiCamps
+**********
+
+Where there is a strong local presence, organizers may wish to create an informal regional event or conference, called a MautiCamp.
+
+These will be regional in nature and organised with support of the Community Team.
+
+Mautic Conferences
+******************
+
+We hold annual Mautic Conference events which bring together the international community for a formal conference. Mautic Conference exists in two flavors:
+
+-  Mautic Conference Global, which is held virtually
+-  Mautic Conference , real-life, intended to move to a different continent every year.
+
+The first such event took place in 2020 - originally planned as an on-premise event, but converted to a virtual event due to the 2020 pandemic.
+
+Mautic Conference is organised by the community and invites sponsors to support the event. If you are interested in getting involved in any way, please join :xref:`Mauticon Slack` on Slack (get an invitation at :xref:`Mautic Community Slack`).