added tiles for the admin guide

Author: amaksimovv

docs/admin-guide.en.md

@@ -0,0 +1,25 @@
+---
+title: "Admin guide"
+hide:
+  - toc
+---
+
+# Admin guide
+
+Select a documentation section:
+
+<div class="guide-hub">
+  <a class="guide-card" href="/on-premise/server-requirements.en/">
+    <div class="guide-card__head">
+      <span class="guide-card__title">Installation and maintenance</span>
+    </div>
+    <p class="guide-card__text">Installation requirements, deployment options, system maintenance, updates, and troubleshooting.</p>
+  </a>
+
+  <a class="guide-card guide-card--general" href="/on-premise/how-to/activation.en/">
+    <div class="guide-card__head">
+      <span class="guide-card__title">Platform setup</span>
+    </div>
+    <p class="guide-card__text">System activation, access management, LDAP/OIDC configuration, and core administrative setup.</p>
+  </a>
+</div>

docs/admin-guide.md

@@ -0,0 +1,25 @@
+---
+title: "Руководство администратора"
+hide:
+  - toc
+---
+
+# Руководство администратора
+
+Выберите раздел документации:
+
+<div class="guide-hub">
+  <a class="guide-card" href="/on-premise/server-requirements/">
+    <div class="guide-card__head">
+      <span class="guide-card__title">Установка и эксплуатация</span>
+    </div>
+    <p class="guide-card__text">Требования к установке, варианты развертывания, обслуживание, обновление и диагностика.</p>
+  </a>
+
+  <a class="guide-card guide-card--general" href="/on-premise/how-to/activation/">
+    <div class="guide-card__head">
+      <span class="guide-card__title">Настройка платформы</span>
+    </div>
+    <p class="guide-card__text">Активация системы, управление доступом, LDAP/OIDC и базовые административные настройки.</p>
+  </a>
+</div>

docs/css/hide_lang_links.css

@@ -2,8 +2,10 @@
   display: none
 }
 
-/* Hide duplicated section index link in left navigation for User guide.
-   Keep top tabs and routing behavior intact. */
+/* Hide duplicated section index links in the left navigation:
+   top-level "Admin guide" and "User guide" each have an index entry as
+   the first child; hide those entries in all contexts. */
+.md-sidebar--primary input#__nav_3 ~ nav.md-nav > ul.md-nav__list > li.md-nav__item:first-child,
 .md-sidebar--primary input#__nav_4 ~ nav.md-nav > ul.md-nav__list > li.md-nav__item:first-child {
   display: none !important;
 }

docs/index.en.md

@@ -22,7 +22,7 @@ hide:
       </a>
     </h2>
     <div class="hero-buttons">
-      <a href="/on-premise/server-requirements/" class="btn btn-primary">Admin guide</a>
+      <a href="/admin-guide.en/" class="btn btn-primary">Admin guide</a>
       <a href="/user-guide.en/" class="btn btn-secondary">User guide</a>
     </div>
   </div>

docs/index.md

@@ -22,7 +22,7 @@ hide:
       </a>
     </h2>
     <div class="hero-buttons">
-      <a href="/on-premise/server-requirements/" class="btn btn-primary">Руководство администратора</a>
+      <a href="/admin-guide/" class="btn btn-primary">Руководство администратора</a>
       <a href="/user-guide/" class="btn btn-secondary">Руководство пользователя</a>
     </div>
   </div>

docs/stylesheets/extra.css

@@ -274,7 +274,7 @@
 }
 
 .guide-card__title {
-  color: var(--md-default-fg-color);
+  color: #ffffff;
   font-size: 1.04rem;
   font-weight: 700;
 }
@@ -287,7 +287,7 @@
 }
 
 .guide-card--general .guide-card__title {
-  color: #ff3d6c;
+  color: #ffffff;
 }
 
 .version-tag {

docs/user-guide.en.md

@@ -19,7 +19,7 @@ Select a documentation section:
       <img src="/assets/icons/osa.svg" alt="CodeScoring.OSA logo" />
       <span class="guide-card__title">CodeScoring.OSA</span>
     </div>
-    <p class="guide-card__text">Open Source supply chain protection, policy enforcement, and component control.</p>
+    <p class="guide-card__text">open source supply chain protection, policy enforcement, and component control.</p>
   </a>
 
   <a class="guide-card" href="/sca/index.en">

docs/user-guide.md

@@ -19,7 +19,7 @@ title: "Руководство пользователя"
       <img src="/assets/icons/osa.svg" alt="CodeScoring.OSA logo" />
       <span class="guide-card__title">CodeScoring.OSA</span>
     </div>
-    <p class="guide-card__text">Защита цепочки поставок Open Source, политики и контроль компонентов в репозиториях.</p>
+    <p class="guide-card__text">Защита цепочки поставок open source, политики и контроль компонентов в репозиториях.</p>
   </a>
 
   <a class="guide-card" href="/sca/">

mkdocs.yml

@@ -99,8 +99,10 @@ plugins:
           webhooks: "Setting up webhooks"
           api: "Working with API"
           author-audit: "Calculating number of authors"
+          admin-guide-intro: "Admin guide"
           user-guide: "User guide"
           general: "General"
+          general-intro: "General"
           policies: "Security policies"
           policies-settings: "Managing policies"
           artifact-plugins: "Plugins for repositories"
@@ -262,8 +264,10 @@ plugins:
           webhooks: "Подключение вебхуков"
           api: "Работа с API"
           author-audit: "Аудит количества авторов"
+          admin-guide-intro: "Руководство администратора"
           user-guide: "Руководство пользователя"
           general: "Общее"
+          general-intro: "Общее"
           policies: "Политики безопасности"
           policies-settings: "Настройка политик"
           artifact-plugins: "Плагины для хранилищ"
@@ -419,6 +423,8 @@ nav:
     - standards: standards.md
     - standards: standards.en.md
   - admin-guide:
+    - admin-guide-intro: admin-guide.md
+    - admin-guide-intro: admin-guide.en.md
     - installation:
       - hardware: on-premise/server-requirements.md
       - hardware: on-premise/server-requirements.en.md
@@ -470,8 +476,8 @@ nav:
     - user-guide.md
     - user-guide.en.md
     - general:
-      - on-premise/how-to/general/index.md
-      - on-premise/how-to/general/index.en.md
+      - general-intro: on-premise/how-to/general/index.md
+      - general-intro: on-premise/how-to/general/index.en.md
       - user-profile: on-premise/how-to/user-profile.md
       - user-profile: on-premise/how-to/user-profile.en.md
       - policies: