temujin 7 дек 2016 в 21:10

Документация Linux ядра переходит на Python Sphinx

7 мин

21K

Open source*Python*Sphinx*Разработка под Linux*

+43

Комментарии 14

crazylh 7 дек 2016 в 22:06

Только дочитав до конца становится понятно что речь идет про питон, а не про Sphinx Search Engine.

temujin 7 дек 2016 в 22:06

Учел Ваше замечание, поменял текст до ката.

ssbb 7 дек 2016 в 22:09

Совет — перечитывайте текст перед публикацией. Не смог прочитать больше пары предложений. Очень похоже на google translate :)

temujin 7 дек 2016 в 22:17

Скоро это может быть комплиментом. А если серьезно, буду признателен за конкретику.

xyvainz 8 дек 2016 в 07:39

Ой, да хоть бы одна статья-перевод на habrahabr'е обошлась без «азаза, гугл-тренслейт, памагитемаиглаза» ;)

safinaskar 8 дек 2016 в 01:20

Если вы подписывает расходные ордера и разбираетесь в бюджетировании, тогда вы точно не старший разработчик ядра.

Здесь manager следовало бы перевести именно как менеджер. И вообще переведите процитированный абзац целиком, желательно сохранив его дух

temujin 8 дек 2016 в 07:57

Как бы вы написали? Мне не очень понравилось «менеджер», и я не собирался дословно переводить этот абзац, там написано с юмором у меня вряд-ли получится хорошо все передать.

safinaskar 8 дек 2016 в 12:00

В этом абзаце автор говорит, что слово "manager" не нужно понимать в том смысле, в котором его понимают обычно. Что это не тот, кто подписывает всякие акты приёма-передачи. Если при переводе заменить "manager" на "старший разработчик", смысл теряется.

Я бы перевёл так:

Кстати, когда говрят "менеджер ядра", имеют в виду тех, кто управляет разработкой, а не тех, кто занимается обычным менеджментом в компаниях. Если вы подписываете заказы на покупку или имеете хоть какое-то представление о бюджете команды, вы точно не менеджер ядра. Эти советы могут относится, а могут и не относиться к вам

temujin 8 дек 2016 в 12:18

Отлично перевели! Только «менеджер ядра», мне как-то диковато. Давайте проверим, если не будет лучшего варианта, с Вашего позволения я добавлю перевод в сноску.

safinaskar 8 дек 2016 в 01:25

Это перевод? Тогда поставьте сверху значок "перевод". Если не получается, то хотя бы в первой строчке напишите, что это перевод и поставьте ссылку на оригинал. Так принято

temujin 8 дек 2016 в 07:58

Нет, это не перевод а источники в конце указаны в разделе «Использованные Материалы»..

gimntut 8 дек 2016 в 11:33

Разве?

Забавно, сто лет назад у меня тоже была электронная почта на usa.net, но после обвала на рынке DotCom, она стала платной и я пересел на Yahoo.

temujin 8 дек 2016 в 11:43

У меня самого была почта на usa.net и адресс кажется был miko.g@usa.net или miko.g@netaddress.com. Я написал про себя. Да, я не юн.

nick_volynkin 3 мая 2017 в 05:03

конвертированы в ReStructuredText с помощью питоновского Сфинкса

Судя по документации, они конвертируют документы из DocBook в rST с помощью скрипта, использующего под капотом pandoc.

А статья отличная, спасибо. Рад за разработчиков ядра Linux – новый формат документации гораздо удобнее.

Зарегистрируйтесь на Хабре, чтобы оставить комментарий

Показать лучшие за всё время