На второй неделе мне пришлось тратить меньше времени на поиск проблемы. На этот раз это была ошибка, возникшая в темном режиме на веб-сайте документации Mattermost, где определенная кнопка имела неправильный цвет.

Я знаю о Docusaurus, так как видел другую документацию и некоторые сайты с материалами нашего курса, созданные на его основе. Под капотом он использует React, поэтому я был с ним знаком. Но этот сайт документации был написан на Python. Хотя я не фанат Python, он меня заинтриговал, поскольку он написан не только на Python, а точнее, с использованием Sphinx, который использует reStructuredText в качестве языка разметки. Там же был Makefile. Много нового, но выглядело очень интересно.

Поэтому я хотел поработать над этой проблемой. Выразив свою заинтересованность и получив порученную мне задачу, я начал над ней работать. Хотя процесс установки очень прост, поскольку большую его часть автоматизируют сценарии, у меня возникла небольшая проблема. Я использую WSL (подсистему Windows для Linux) в качестве среды разработки. Хотя у меня есть обе версии, у меня есть версии Python 2.7 и 3.10 в WSL, у меня возникли проблемы с установкой версии 3.10 в качестве версии по умолчанию, и, поскольку для настройки приложения мне нужен Python 3.9 или более поздняя версия, я получал сообщение об ошибке. Поэтому, проведя некоторое расследование и выяснив виновника, я переключился на свою родную среду Windows. После этого все пошло гладко. Я был немного удивлен, сколько времени заняла вся компиляция. Это заняло на удивление много времени, и я подозреваю, что виноват питон. Внося изменения в стиль конкретной кнопки в conf.py, мне пришлось выполнить повторную компиляцию, и проблема, похоже, была решена.

Итак, моим следующим шагом было сделать пиар. Во время написания PR-описания я увидел ссылки на веб-сайт Mattermost с рекомендациями по участию, поэтому мне пришлось зарегистрироваться и подписать документы, чтобы иметь возможность внести свой вклад, и чтобы моя учетная запись GitHub отображалась в качестве участника. Мне прочитали правила гильдии, чтобы сделать правильный пиар. Пройдя все, я сделал пиар, а затем пришло время ожидания. На момент написания этой статьи PR все еще открыт, даже спустя 5 дней. После того, как моя проверка кода была принята, нужно было провести контроль качества, который занял больше всего времени. На момент написания этой статьи были проведены как проверка кода, так и контроль качества, поэтому их объединение и закрытие — лишь вопрос времени.

В течение второй недели было довольно весело и интересно работать над репозиторием компании и видеть, как разворачивается весь процесс. Хотя проект написан на Python, работать над ним оказалось на удивление легко.