265

Полная и свежая документация по Django Rest Framework

Полная и свежая документация по Django Rest Framework

Собственно, всем желающим: https://github.com/ilyachch/django-rest-framework-rusdoc

Еще в 2017 году я задумал сделать перевод документации по DRF. И начинал с перевода вручную. После перевода Quickstart понял, что так дело не пойдет. Начал переводить с помощью переводчиков с редактурой. Стало чуть быстрее.

Нормально так подзадобавшись, написал простенький скрипт, который принимал Markdown файл и переводил его, добавляя после каждого блока текста переведенный блок. В некоторых случаях, получалось относительно неплохо.

Сейчас проект поддерживается в максимально актуальном состоянии:

  • каждую неделю по крону выкачивается документация оригинала и сравниваются хэши файлов у меня и в источнике (можно посмотреть код workflow гитхаб экшенов)

  • в случае наличия изменений, автоматом создается ветка и pull-request, которые я обрабатываю за пару дней (по мере наличия времени)

  • все изменения проходят мою ручную редактуру

Если кому-то будет полезно, буду рад.

Программирование на python

928 постов11.9K подписчиков

Правила сообщества

Публиковать могут пользователи с любым рейтингом. Однако!


Приветствуется:

• уважение к читателям и авторам

• конструктивность комментариев

• простота и информативность повествования

• тег python2 или python3, если актуально

• код публиковать в виде цитаты, либо ссылкой на специализированный сайт


Не рекомендуется:

• допускать оскорбления и провокации

• распространять вредоносное ПО

• просить решить вашу полноценную задачу за вас

• нарушать правила Пикабу