Проект «Открытые факты о еде»

На этой странице содержится подробная информация о проекте технического написания, принятом для участия в Google Season of Docs.

Краткое описание проекта

Организация с открытым исходным кодом:
Факты об открытой еде
Технический писатель:
БудущееДокументов
Название проекта:
Документирование API Open Food Facts
Длина проекта:
Длительный ход (5 месяцев)

Описание проекта

Впервые я услышал о «Сезоне документации» из электронного письма, которое получил от преподавателя курса по документации REST API, который я прошел несколько месяцев назад. Хотя мне очень понравилась эта идея, я решил, что подам заявку на участие в проекте только в том случае, если смогу действительно идентифицировать себя с ним. Это было чем-то, чем я хотел бы заниматься помимо своей основной работы, и если бы я это делал, это должно было бы быть весело и значимо.

Когда я прочитал описание «Фактов об открытой еде», я понял, что нашел этот проект. Я люблю заботиться о своем теле и здоровье посредством физических упражнений и еды. Я действительно считаю, что питание — один из ключей к счастливой жизни, и мы все должны иметь возможность делать лучший выбор, что возможно только в том случае, если у нас есть достаточно информации о продуктах питания и косметике, которые мы используем. Open Food Facts предоставляет эту информацию в наше распоряжение, и я хочу внести свой вклад в эту замечательную инициативу.

Последние три года я работал техническим писателем в компании по разработке программного обеспечения, специализирующейся на автоматизации процессов и выпусков. Среди прочего мы реализовали REST API с помощью Swagger, который позволяет разработчикам взаимодействовать с нашими приложениями через запросы API. Я помог командам разработчиков написать более качественные описания запросов/ответов, и вместе мы определили, какая информация необходима нашим клиентам, чтобы предоставить ее в ясной и краткой форме.

Я просматривал текущий сайт API Open Food Facts и думаю, что мы можем реструктурировать и улучшить документацию, чтобы сделать ее более удобной для пользователя (страницы «Общие», «ЧТЕНИЕ», «ЗАПИСЬ»). Кроме того, мне бы хотелось вместе с командами разработчиков настроить способ автоматического создания документации API из кода (это требует времени, поэтому я предлагаю долгосрочное сотрудничество).

Мы все знаем, что внешний вид важен;) Вот почему мы также можем настроить CSS и логотип REST API, чтобы согласовать пользовательский интерфейс Swagger с пользовательской документацией.

Я с нетерпением жду возможности поработать с вами над этим проектом!