Education Team

Missions and expectations of the Education Team

The core mission of the Education Team is to empower the Mautic community by maintaining comprehensive, high-quality documentation and learning resources.

The team ensures that all resources are high-quality, easy to understand, and accurate for each release. They also monitor the Community Forums to identify recurring issues, common questions, and gaps in existing documentation. The team continuously works to improve learning resources for both new and experienced users.

The main objective is to improve the user experience by providing clear, comprehensive support and ensuring that all documentation and essential resources are available in multiple languages for a global audience.

General tasks for the Education Team

  • Maintaining high-quality and current documentation

    • Keep the documentation clear, accurate, and consistently high-quality.

    • Ensure that the documentation is up to date with new releases.

    • Improve the experience of Mautic Users by ensuring that the documentation is comprehensive and highly usable.

    • Help marketers contribute their existing content to the Mautic Knowledgebase.

  • Forums analysis & resource development

    • Monitor the Mautic Community Forums to proactively identify recurring questions, common issues, and persistent themes that indicate documentation gaps.

    • Develop high-quality documentation and learning resources based on the solutions to the frequently asked questions.

  • Enhancing user learning and global accessibility

    • Improve the resources available for new and established Users to learn how to use Mautic.

    • Ensure multilingual availability for documentation and key user resources.

Forums

Quality of contributions

  • Are the answers to the asked questions correct? Ensure indication of the correct solutions if this is the case.

  • Is it an often asked question? Then, add it to the documentation.

  • Are there multiple posts about the same thing? Then, merge into a mega-post.

Forums rules

  • Which rules are appropriate

  • Which rules are relevant / needed to keep the Forums working fine

  • Moderate Forums or assign moderators

  • Moderate posts by themselves

  • Elect moderators who moderate the Forums for them

  • Redirect all Support questions from Slack to Forums

  • Very visible hint in Slack that support questions aren’t answered there

  • Manually moderating Slack & moving stuff to Forums

  • Automatically moving stuff to Forums?

Documentation

Sources

  • User Documentation describes key concepts of Mautic and provides instructions for using and contributing to Mautic.

  • Knowledgebase provides a database of tutorials, FAQs, and how-to articles.

  • Developer Documentation details about the Mautic API, Webhooks, Themes and Plugin development.

  • Community Handbook is a central point of call for documentation on the organization and management of the Mautic community.

Quality

  • Maintaining a high quality

  • Review the accuracy of the documentation

  • Keeping it easy to understand

Completeness

  • Add missing topics to the documentation

  • Proactively reviewing site/Google searches and identifying topics to write if there are missing areas

  • Manage issue queue on the documentation and community handbook GitHub repositories

  • Adding highly requested Forums questions

Up to date

  • Ensuring that the documentation is up to date with major releases

  • Document changes coming with those releases

  • Merge PRs when they come in for new features

Languages

  • Keeping native translations accurate

  • If necessary, add more translations

Style guide

The Mautic Style Guide recommends best practices to achieve a consistent style, voice, and tone across all documentation.

Any Technical Writer - or other contributor - can make suggestions for documentation style updates.

Educational blog content

  • Curating and writing content for the community blog

  • Curating and writing how-to articles and tutorials for the Mautic Knowledgebase

Mautic app and website/marketing internationalization

  • Own Transifex and appropriate workflows

  • Manage multilingual marketing materials - for example, website, fliers, etc.

  • Work tightly with Community, Product and Marketing teams

Profiles of contributors needed in the Education Team

The Education Team needs insights from:

  • New Users

  • Established Users

  • Administrators

  • Developers

  • Theme builders

  • Business owners considering Mautic

  • Business buyers/procurements

The Education Team needs people with skills as:

  • Trainers

  • Marketers

  • Video producers

  • Content creators

  • Documentation writer

  • Editors

  • Translators

Note

Would you like to get involved in this team? Join #t-education on Mautic Community Slack.