TDB (iproto): restructure the docs

[xuniq]

Epic: #4002
Product: Tarantool DB
Repository:

• https://github.com/tarantool/tarantooldb/

SME: @ a1div0 @ Galiev-Ruslan

Details

Structure template

• Руководство для начинающих
• Установка и обновление
• Руководство пользователя
• Руководство администратора
  • Руководство по решению проблем
• Справочник
• Примечания к версиям

Suggested structure

The new structure is described in the doc:

https://docs.google.com/document/d/1t0s0CWA6iEyzbvr7dbQlgFqfg1_yjja5JTOd7TF2EHw/edit

Definition of done

In scope of this issue:

• Check the current structure in the docs
• Create a new structure with the existing content based on the template
• Validate it with @ a1div0 @ Galiev-Ruslan
• Restructure the existing docs according to the new plan
• Add sphinx config files and test a local doc build

Note that the docs will not be proofread in scope of this issue. This will be done later.

Локальная сборка

Какие остались проблемы и вопросы:

1. В toctree нельзя напрямую добавить файл, который находится за пределами doc-проекта (например, README в корне репозитория). Есть workaround для myst, где в toctree добавляется .md с include, но вместо инклюда видна только пустая страница:
   https://myst-parser.readthedocs.io/en/v0.16.0/sphinx/use.html#include-a-file-from-outside-the-docs-folder-like-readme-md

Сейчас в структуре несколько md-файлов, которые находятся за пределами doc (README в корне репозитория и содержимое ../client/utils/.md). Нужно либо найти обходной путь, чтобы добавить в токтри эти файлы или как-то копировать контент?

2. Во всех md-файлах с toctree использована директива myst {toctree}. Единственный файл, где не получилось так собрать toctree - в главном index.md. Собрать его получается, только используя в файле rst-обертку для токтри, директива {toctree} из myst у меня не тут не сработала. Пример обертки:

..  toctree::
    :caption: Содержание:
    :maxdepth: 2
    
    overview
    getting_started
    install_and_upgrade
    user_guide
    admin_guide
    reference
    releases

3. В структуре осталось несколько файлов, которые еще не добавлены ни в какой toctree + остались старые ссылки/якоря, которые будет постепенно обновлены.