Comments 52
Нет, я не перевожу комментарии. Я считаю (лично мое мнение), что комментарии в коде должны быть на английском.Абсолютно правильное мнение.
ps. Спасибо и ждем pdf.
+9
Спасибо!
0
Вы знаете, я много за свою жизнь видел кода, но мало комментариев на английском, я видел кучу коментариев на языке с английскими корнями, которые при переводе выглядят как «я твой дом труба шатал». Непонятно зачем цепляться за такой таджикоанглийский, лучше уж писать на русском.
+2
Всегда существует вероятность того, что Ваш код будет поддерживать не носитель русского языка. Английский просто универсальнее.
+3
Евгений, вы неоставляете возможность иностранному разработчику поддерживать код. Это может быть офшорная разработка или разработчик-иностранец в вашей компании. Английский в любом его исполнении понимается большинством разработчиков, поэтому «дом труба шатал», лучше чем "ハウスパイプ揺れ".
+1
Скопирует в ГуглТранслейт и получит тот же результат, что я бы написал (а может к тому времени транслейт ещё поумнеет и результат будет лучшем чем на момент написания кодв). Но если у него рядом (или на связи) будет человек, знающий хорошо и русский, и английский, то сможет нормально переписать на английском. А если гугл даст мне английский аналог «дом труда шатал», то я могу его понять (будь английский мой родной) и как «дом трубу шатал» и как «у дома шаталась труба». и как «дом с трубой шатался» и ещё кучей способов.
Так что лучше писать комментарии на русском «сколько времени» чем на «английском» «how many time». Проверено на работе в трехязычной команде, где лишь два человека хорошо владели двумя языками, причем общий для них был немецкий. Я писал на русском, немец переводил с русского на немецкий и свои комменты на немецком писал, а англичанин с немецкого на английский. переводил. В итоге почти все комменты были переведны с обычного русского и обычного немецкого на английский. но всё это так, без особого напряга, типа встретился коммент и переводят. Патчей только с переводом обычно не было. А собственно предложил такую систему ввести англичанин, как ему надоело узнавать что же мы имели в виду написав «дом труба шатал». :)
Так что лучше писать комментарии на русском «сколько времени» чем на «английском» «how many time». Проверено на работе в трехязычной команде, где лишь два человека хорошо владели двумя языками, причем общий для них был немецкий. Я писал на русском, немец переводил с русского на немецкий и свои комменты на немецком писал, а англичанин с немецкого на английский. переводил. В итоге почти все комменты были переведны с обычного русского и обычного немецкого на английский. но всё это так, без особого напряга, типа встретился коммент и переводят. Патчей только с переводом обычно не было. А собственно предложил такую систему ввести англичанин, как ему надоело узнавать что же мы имели в виду написав «дом труба шатал». :)
+2
Это еще и хорошая прокачка английского, если не практиковаться так и будет разработчик всю жизнь «труба шатал» — я только из-за этого и пишу по-английски комменты.
И еще есть что-то чуждое в кириллице в коде.
И еще есть что-то чуждое в кириллице в коде.
0
Долго вы уже пишите такие комментарии? Насколько хорошо знаете английский? Можно подумать, английский — это только слова. Языковые конструкции и прочее не прокачать комментариями — поправить-то вас некому.
+1
В таком случае языку нельзя обучиться самостоятельно, если судить по вашей логике: у меня нет преподавателей и носителей языка — т.е. поправить меня некому.
Но и слова тоже. Одними комментариями сыт не будешь, правда: нужны аудио и видео, книги и журналы. Однако, если попытаться перевести сложный коммит, мозг начнет напрягаться — это хорошо, не так ли?
Можно подумать, английский — это только слова.
Но и слова тоже. Одними комментариями сыт не будешь, правда: нужны аудио и видео, книги и журналы. Однако, если попытаться перевести сложный коммит, мозг начнет напрягаться — это хорошо, не так ли?
0
В таком случае языку нельзя обучиться самостоятельно, если судить по вашей логике: у меня нет преподавателей и носителей языка — т.е. поправить меня некому.Нет, не правильно. Вы можете взять учебник и выучиться. Только учебник — это методика, там есть последовательность, как выучить язык. Комментарии в коде — не методика изучения языка, максимум — расширение словарного запаса и то до какой-то степени.
Однако, если попытаться перевести сложный коммит, мозг начнет напрягаться — это хорошо, не так ли?Или вы его переведёте неправильно, если его писал неуч, который не отличает «важный» от «импотент».
0
Нет, не правильно. Вы можете взять учебник и выучиться.Надеюсь вы не думаете, что я предлагаю начать изучение английского с написания комментариев в коде?
максимум — расширение словарного запаса и то до какой-то степени.Вы так говорите будто это что-то плохое. Или, грубо говоря, вы со мной согласны, но не согласны? :-)
Практика — она и есть практика, в ней ошибаются и осознают свои ошибки. Написание писем, комментариев к коду, тикетов в трекере, общение на форуме — практика письменного английского.
0
Это если осознаете. Обычно люди не осознают, что они пишут «дом труба шатал». Если каждое слово, вернее каждую грамматическую конструкцию проверяете по справочнику (не забывая про список исключений) — то, да, лучше писать на английском комментарии. Но вряд ли это допустимо в рабочих проектах. Да и в своих тоже уу меня как-то не прижилось — или программировать, или язык изучать.
0
И еще есть что-то чуждое в кириллице в коде.
А, по-моему, нормально: github.com/idlesign/pyyaru/blob/master/pyyaru/pyyaru.py %P
Однако этот пример не говорит о том, что так нужно делать везде, он говорит о том, что нужно понимать целевую аудиторию проекта.
0
Кстати, в виндоус если не писать насильно
print string
, а скажем так print (integer, string)
, в случае кириллицы во втором примере в трейсе будут кракозябры. 0
Да, в win много интересного, только как это относится к комментариям на русском?
0
Напрямую :-) Вы пишите комментарии на русском, вы пишите эксепшены на русском, программа падает, я гляжу в консоль и вижу «РЁРёСЂРѕРєР°СЏ …» — я вынужден искать этот участок в коде.
0
Неа, вы что-то путаете, я исключения на русском не пишу :)
0
Кхм. Какая разница в мотивах? Я имею ввиду, если вы пишите комментарии по-русски, почему эксепшены по-английски? Комментарии и эксепшены — своего рода синонимы, т.к. и те и другие оставляют подсказки разработчику.
0
А я просто не считаю их синонимами, иначе, встав на этот путь, можно и код объявить синонимом — он тоже подсказка разработчику.
Посмотрите на это так: строки документации предназначены тем, кто знакомится с кодом программного продукта, описания в исключениях — тем, кто пользуется программным продуктом.
Посмотрите на это так: строки документации предназначены тем, кто знакомится с кодом программного продукта, описания в исключениях — тем, кто пользуется программным продуктом.
0
Спасибо! Многое просто повторяет PEP8, но всё равно было любопытно прочитать. Скажите, а в чём смысл использования спойлеров в этой статье?
+1
!#/usr/bin/python
не везде работает. Лучше все же #!/usr/bin/env python
, имхо +8
Приведите, пожалуйста, пример. Я просто не встречал…
0
Arch сейчас поставляется с python 3.x в роли основного интерпретатора python'а. Как следствие, путь /usr/bin/python будет указывать на третью версию. Если Вы всё ещё используете вторую ("~95%" (тут могло быть любой число) серьёзной разработки на python'е), то ваш скрипт вполне может и не поехать. Например из-за print или метаклассов.
0
FreeBSD — /usr/local/bin/python.
+3
Люто плюсую. Использование прямого пути к интерпретатору ограничивает использование virtualenv.
+2
Или даже /bin/env python
0
Используйте оператор % для форматирования строк...
Заклинаю, используйте метод format().
+4
Да, все правильно, если бы я публиковал своё мнение, я бы так и написал. Хотя бы потому, что это Python 3 compatible:)
0
Да ладно вам. Переход от 2.7 (гляжу на свой проект и говорю честно) к 3.0 будет все равно, что его переписать. Если он вообще когда-нибудь перейдет. В таком ключе format() это все равно что писать на горящий дом. Да и приятнее иногда старый синтаксис:
А еще вот:
Хотя я понимаю, что это слабый аргумент )
'Hi, %s!' % username
А еще вот:
log.debug('foo: {}'.format(x))
log.debug('foo: %s', x)
Хотя я понимаю, что это слабый аргумент )
0
Я не из-за совместимости, я из-за внешнего вида. Когда 3-4 переменных нужно загнать в строку оператор % внешне уже не выглядит привлекательным лично по-моему мнению.
0
А если 1 переменная (что чаще всего)?
+1
На вкус и цвет :-)
А вот передать 10 аргументов в format(), чтобы оно свалилось в 5 строчек будет не красиво. Если случай действительно сложный, я использую переменные — код так приятнее.
foo = """Hi, %(user)s…%(message)s"""
bar = {'user': username…'message': message}
baz = foo % bar
А вот передать 10 аргументов в format(), чтобы оно свалилось в 5 строчек будет не красиво. Если случай действительно сложный, я использую переменные — код так приятнее.
0
baz = 'Hi, {user}s…{message}s'.format(user=username, message=message)
0
Я хотел сказать, что если аргументов много лично я предпочитаю разделять код на переменные: обратите внимание на многоточие — в таком случае оба подхода выглядят одинаково хорошо.
Опять же, лично мне нравится больше старый синтаксис, если аргумент один или их не больше трех, поэтому я и написал «на вкус и цвет».
Опять же, лично мне нравится больше старый синтаксис, если аргумент один или их не больше трех, поэтому я и написал «на вкус и цвет».
0
Это осколок перлосинктасиса. Поэтому его и меняют.
0
А чем плохо
"%(dict_key_name)s %(dict_key_name2)s %(dict_key_name3)s" % dict
? 0
Ребят, понимаю что оффтопик, начал учить Питон 3.3 для научных целей (анализ соц. сетей и обработка естественного языка).
Подскажите основные ресурсы по Питону на русском, именно форумы чтобы спрашивать, набрал в гугле «python русское сообщество» и ВСЕ первые ссылки это заброшенные форумы, последнее сообщение в которых хорошо если несколько месяцев назад. Самый актуальный это пока vingrad — но и на нем не так чтоб много народу.
Английский знаю и пользуюсь преимущественно pyvideo.org www.codecademy.com/ru/tracks/python и stackoverflow.
Подскажите основные ресурсы по Питону на русском, именно форумы чтобы спрашивать, набрал в гугле «python русское сообщество» и ВСЕ первые ссылки это заброшенные форумы, последнее сообщение в которых хорошо если несколько месяцев назад. Самый актуальный это пока vingrad — но и на нем не так чтоб много народу.
Английский знаю и пользуюсь преимущественно pyvideo.org www.codecademy.com/ru/tracks/python и stackoverflow.
0
UFO just landed and posted this here
Максимальная длина строки — 80 символов
У них мониторы 1024х768 что ли? Почему не 120 символов?
0
Sign up to leave a comment.
Советы Google по кодированию на языке Python. Часть вторая: советы по форматированию исходного кода