Документация Yandex Cloud

Приветствуем в репозитории yandex-cloud/docs. Здесь вы можете предложить дополнения и правки для документации Yandex Cloud или сделать их самостоятельно и получить грант в рамках контент-программы.

Предложить правки

Откройте Issue и напишите свои замечания и предложения там. Мы вернемся с ответом. Если вам требуется помощь в работе с облаком, обратитесь в техническую поддержку.

Поучаствуйте в контент-программе

Контент-программа Yandex Cloud позволяет вам самим написать документацию и получить за нее грант на ваш платежный аккаунт. Поучаствовать в контент-программе можно двумя способами:

1. Если вы заметили опечатку или у вас есть небольшая правка, сделайте PR. Такие правки мы рассматриваем быстро, и обычно они не требуют обсуждения.
2. Если вы хотите написать большой текст, пошаговое руководство или внести крупные смысловые правки, откройте Issue и расскажите, о чем вы хотите написать. Не нужно сразу приносить большой PR: давайте сначала обсудим ваши идеи и вместе решим, как действовать дальше.

Мы принимаем правки во все документы, кроме справочников API, CLI и Terraform. Обратите внимание на список важных тем — за них мы начисляем повышенные гранты.

Чтобы мы знали, куда зачислить грант, обязательно укажите идентификатор вашего платежного аккаунта в Issue или PR.

Про документацию

Документация разработана с использованием синтаксиса Yandex Flavored Markdown.

Как предложить правки

Чтобы предложить правки, вы должны прочитать «Лицензионное Соглашение Яндекса с Контрибьютором» и подтвердить свое согласие с его условиями. Подробная информация о том, как это сделать, и ссылки на текст Соглашения приведены в файле CONTRIBUTING.md.

Если вы заметили опечатку или ошибку в документации или хотите дополнить какой-то раздел, создайте pull request (PR) с правками через GitHub.

Как собрать документацию локально

Для HTML-превью используйте локальный инструмент. Он фиксирует версии Diplodoc и поддерживает таргеты YC, Internal, External, DataLens, SourceCraft и AI Studio. Из корня репозитория:

npm ci --prefix tools/preview
npm run preview --prefix tools/preview -- YC --region ru --lang ru

Команда напечатает путь к собранному HTML и команду для его просмотра в браузере.

MCP-сервер для документации

Вы можете использовать MCP-сервер для генеративного поиска по документации Yandex Cloud. Инструкции по настройке сервера и список поддерживаемых инструментов доступны в официальном репозитории.

Полный список официальных MCP-серверов Yandex Cloud.

Лицензии

© YANDEX LLC, 2018. Licensed under Creative Commons Attribution 4.0 International Public License. See the LICENSE file for more details.