MobileTeleSystems · dmitry-pedchenko · Mar 28, 2024 · Mar 28, 2024 · Mar 28, 2024 · Mar 28, 2024
diff --git a/README.rst b/README.rst
@@ -18,7 +18,7 @@ SyncMaster
 .. |Docker image| image:: https://img.shields.io/docker/v/mtsrus/syncmaster-backend?sort=semver&label=docker
     :target: https://hub.docker.com/r/mtsrus/syncmaster-backend
 .. |Documentation| image:: https://readthedocs.org/projects/data-syncmaster/badge/?version=stable
-    :target: https://data-syncmaster.readthedocs.io/
+    :target: https://syncmaster.readthedocs.io
 .. |Build Status| image:: https://github.com/MobileTeleSystems/syncmaster/workflows/Tests/badge.svg
     :target: https://github.com/MobileTeleSystems/syncmaster/actions
 .. |Coverage| image:: https://codecov.io/gh/MobileTeleSystems/syncmaster/graph/badge.svg?token=ky7UyUxolB
@@ -63,4 +63,4 @@ Non-goals
 Documentation
 -------------
 
-See https://data-syncmaster.readthedocs.io/
+See https://syncmaster.readthedocs.io
diff --git a/docs/_static/custom.css b/docs/_static/custom.css
@@ -0,0 +1,3 @@
+.logo {
+  width: 200px !important;
+}
diff --git a/docs/_static/openapi.json b/docs/_static/openapi.json
@@ -0,0 +1,9 @@
+{
+  "openapi": "3.1.0",
+  "version": "unknown",
+  "info": {
+    "title": "Generated in CI",
+    "version": "unknown"
+  },
+  "paths": {}
+}
diff --git a/docs/_static/redoc.html b/docs/_static/redoc.html
@@ -0,0 +1,28 @@
+
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>SyncMaster - ReDoc</title>
+    <!-- needed for adaptive design -->
+    <meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+
+    <link rel="shortcut icon" href="../_static/icon.svg">
+    <!--
+    ReDoc doesn't change outer page styles
+    -->
+    <style>
+      body {
+        margin: 0;
+        padding: 0;
+      }
+    </style>
+  </head>
+  <body>
+    <noscript>
+        ReDoc requires Javascript to function. Please enable it to browse the documentation.
+    </noscript>
+    <redoc spec-url="../_static/openapi.json"></redoc>
+    <script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"></script>
+  </body>
+</html>
diff --git a/docs/_static/swagger.html b/docs/_static/swagger.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta
+    name="description"
+    content="SwaggerUI"
+  />
+  <title>SwaggerUI</title>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css" />
+  <link rel="shortcut icon" href="../_static/icon.svg">
+</head>
+<body>
+  <div id="swagger-ui"></div>
+  <script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js" crossorigin></script>
+  <script>
+    window.onload = () => {
+      window.ui = SwaggerUIBundle({
+        url: '../_static/openapi.json',
+        dom_id: '#swagger-ui',
+      });
+    };
+  </script>
+</body>
+</html>
diff --git a/docs/design/permissions.rst b/docs/design/permissions.rst
@@ -1,7 +1,7 @@
 .. _role-permissions:
 
-Roles and rules
-===============
+Roles and permissions
+=====================
 
 - Object within the group can be seen/interacted with only by users which are members of the group.
 - Permissions are limited by role assigned to user within specific group.

diff --git a/docs/index.rst b/docs/index.rst
@@ -1,7 +1,5 @@
 .. include:: ../README.rst
 
-.. include:: ../README.rst
-
 .. toctree::
     :maxdepth: 2
     :caption: High-level design

diff --git a/poetry.lock b/poetry.lock
diff --git a/pyproject.toml b/pyproject.toml
@@ -36,6 +36,7 @@ exclude = [
 
 [tool.poetry.urls]  # Optional
 "Homepage" = "https://github.com/MobileTeleSystems/syncmaster"
+"Documentation" = "https://syncmaster.readthedocs.io"
 "Source" = "https://github.com/MobileTeleSystems/syncmaster"
 "CI/CD" = "https://github.com/MobileTeleSystems/syncmaster/actions"
 "Tracker" = "https://github.com/MobileTeleSystems/syncmaster/issues"
@@ -210,6 +211,7 @@ towncrier = {version = "^23.11.0", python = ">=3.8"}
 sphinx-issues = {version = ">=3.0.1,<5.0.0", python = ">=3.8"}
 sphinx-design = {version = "^0.5.0", python = ">=3.8"}
 sphinx-favicon = {version = "^1.0.1", python = ">=3.8"}
+sphinx-argparse = {version = "^0.2.5", python = ">=3.8"}
 # uncomment after https://github.com/zqmillet/sphinx-plantuml/pull/4
 # sphinx-plantuml = {version = "^1.0.0", python = ">=3.8"}