From 18c15daacd3fa6f4a90207f731dfd4b3b2464f51 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Fri, 17 Jan 2025 18:51:46 +0100 Subject: [PATCH] DISTMYSQL-499 [DOC]Update the Get Help widget and add Get help page 8.4 (#191) new file: _resource/.icons/groups.svg modified: _resource/overrides/main.html new file: _resource/overrides/partials/banner.html new file: docs/css/extra.css new file: docs/get-help.md modified: mkdocs-base.yml deleted: snippets/services-banner.md --- _resource/.icons/groups.svg | 1 + _resource/overrides/main.html | 3 +++ _resource/overrides/partials/banner.html | 9 ++++++++ docs/css/extra.css | 12 ++++++++++ docs/get-help.md | 28 ++++++++++++++++++++++++ mkdocs-base.yml | 5 +++-- snippets/services-banner.md | 10 --------- 7 files changed, 56 insertions(+), 12 deletions(-) create mode 100644 _resource/.icons/groups.svg create mode 100644 _resource/overrides/partials/banner.html create mode 100644 docs/css/extra.css create mode 100644 docs/get-help.md delete mode 100644 snippets/services-banner.md diff --git a/_resource/.icons/groups.svg b/_resource/.icons/groups.svg new file mode 100644 index 00000000..3b42ea55 --- /dev/null +++ b/_resource/.icons/groups.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/_resource/overrides/main.html b/_resource/overrides/main.html index d9c58790..67dba3a0 100644 --- a/_resource/overrides/main.html +++ b/_resource/overrides/main.html @@ -49,6 +49,9 @@
{% include "partials/toc.html" %}
+
+ {% include "partials/banner.html" %} +
{% endif %} diff --git a/_resource/overrides/partials/banner.html b/_resource/overrides/partials/banner.html new file mode 100644 index 00000000..e4cb58b7 --- /dev/null +++ b/_resource/overrides/partials/banner.html @@ -0,0 +1,9 @@ +
+

+

For help, click the link below to get free database assistance or contact our experts for personalized support.

+ +
+ + Get help from Percona +
+
diff --git a/docs/css/extra.css b/docs/css/extra.css new file mode 100644 index 00000000..5487a2ca --- /dev/null +++ b/docs/css/extra.css @@ -0,0 +1,12 @@ +@media print { + /* Adjusts positioning of admonition icon */ + .md-typeset :is(.admonition-title,summary):before { + top: 0.6rem; + left: 0.6rem; + } + } + + .md-sidebar__inner { + font-size: 0.65rem; /* Font size */ + line-height: 1.6; + } \ No newline at end of file diff --git a/docs/get-help.md b/docs/get-help.md new file mode 100644 index 00000000..cdec7bfd --- /dev/null +++ b/docs/get-help.md @@ -0,0 +1,28 @@ +# Get help from Percona + +This guide is packed with information but can’t cover everything you need to know about Percona Distribution for MySQL or every scenario you might encounter. + +Think of this guide as a solid starting point. There’s always more to learn, and you’ll keep discovering new things as you get hands-on experience. And remember, the more you experiment and work with Percona Distribution for MySQL, the more confident and skilled you’ll become. Don’t be afraid to try things out and ask questions when you get stuck. + +The Percona Distribution for MySQL offers powerful features for performance optimization, security, and high availability, but configuring and tuning these tools can be complex and time-consuming. You may face difficulties with the learning curve of advanced features, managing resource-intensive components, ensuring compatibility with existing systems, and troubleshooting performance issues. + +=== ":groups: Ask a question in the Community Forum" + + Be a part of a space where you can tap into a wealth of knowledge from other database enthusiasts and experts who work with Percona’s software every day. While our service is entirely free, keep in mind that response times can vary depending on the complexity of the question. You are engaging with people who genuinely love solving database challenges. + + I recommend visiting our [Community Forum](https://forums.percona.com/t/welcome-to-perconas-community-forum/7){:target="_blank"}. It’s an excellent place for discussions, technical insights, and support around Percona database software. If you’re new and feeling a bit unsure, our [FAQ](https://forums.percona.com/faq){:target="_blank"} and [Guide for New Users](https://forums.percona.com/t/faq-guide-for-new-users/8562){:target="_blank"} ease you in. + + If you have thoughts, feedback, or ideas, the community team would like to hear from you at [Any ideas on how to make the forum better?](https://forums.percona.com/t/any-ideas-on-how-to-make-the-forum-better/11522){:target="_blank"}. We’re always excited to connect and improve everyone's experience. + +=== ":percona-logo: Work with a Percona Expert" + + [Percona experts](https://www.percona.com/services/consulting){:target="_blank"} bring years of experience in tackling tough database performance issues and design challenges. We understand your challenges when managing complex database environments. That's why we offer various services to help you simplify your operations and achieve your goals. + + | Service | Description | + |----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------| + | 24/7 Expert Support | Our dedicated team of database experts is available 24/7 to assist you with any database issues. We provide flexible support plans tailored to your specific needs. | + | Hands-On Database Management | Our managed services team can take over the day-to-day management of your database infrastructure, freeing up your time to focus on other priorities. | + | Expert Consulting | Our experienced consultants provide guidance on database topics like architecture design, migration planning, performance optimization, and security best practices. | + | Comprehensive Training | Our training programs help your team develop skills to manage databases effectively, offering virtual and in-person courses. | + + We're here to help you every step of the way. Whether you need a quick fix or a long-term partnership, we're ready to provide your expertise and support. \ No newline at end of file diff --git a/mkdocs-base.yml b/mkdocs-base.yml index c4b8a2ca..07d55f09 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -95,8 +95,8 @@ markdown_extensions: custom_checkbox: true pymdownx.snippets: base_path: ["snippets"] - auto_append: - - services-banner.md +# auto_append: +# - services-banner.md pymdownx.highlight: use_pygments: true pymdownx.emoji: @@ -146,6 +146,7 @@ extra: nav: - Home: index.md + - get-help.md - Release notes: - Release notes index: release-notes.md - Percona Distribution for MySQL using Percona Server for MySQL: diff --git a/snippets/services-banner.md b/snippets/services-banner.md deleted file mode 100644 index 8d62fab6..00000000 --- a/snippets/services-banner.md +++ /dev/null @@ -1,10 +0,0 @@ -
- -## Get expert help { .title } - -If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services. - -
- -[:material-forum-outline: Community Forum](https://forums.percona.com/){:target="_blank"} [:percona-logo: Get a Percona Expert](https://www.percona.com/about/contact){:target="_blank"} -