Недавно начал изучать Java и сейчас заканчиваю небольшой web-проект для, так сказать, портфолио (надо же хоть что-то помимо junior-резюме показать)  
Маленькая программа для русскоязычных пользователей, что-то вроде системы управления офисной АТС. Пара десятков классов, несколько JSP. 

Осталось снабдить программку внятными комментариями. Вот сижу в раздумьях по-поводу выбора языка. Выходят такие "плюсы-минусы":

Английский:
+ Работодатель сразу поймет, что перед ним человек не просто так написавший в резюме "английский на уровне чтения технической документации" =)
+ Полистав первый том Хорстманна, можно соорудить подобие javadoc'a без "смеси французского с нижегородским".

- Зачем для проекта сугубо местного пользования комментарии на английском?.. Не будет ли это выглядеть хм.. неестественно?
- javadoc - вещь, наверное, замечательная. Но, насколько я понял, в основном, для инструментальщиков, а не прикладных программистов.
- Основное: с языком у меня не высший класс, прямо говоря. Перевести - еще куда ни шло, а вот самому составить правильные - с учетом грамматики (артикли, времена) - предложения - это несколько сложнее, на 3+. Не сделаю ли я сам себе "медвежью услугу"?

Русский:
+ Русский проект - русский язык =)

- ... даже не знаю, может использование русского в комментариях - это моветон в разработке? (хотелось бы верить, что это не так)

В связи с этим я решил оформить свои раздумья в печатном виде и предложить уважаемым участникам форума в качестве голосования.

Возможно, эта тема не стоит того, чтобы устраивать из нее аж голосование. В этом случае пары полезных комментариев по теме будет вполне достаточно  

Это сообщение отредактировал(а) nc30 - 16.11.2010, 17:47

Комментарии ? В проектах ? Хм 

ЕСТЕСТВЕННО НА АНГЛИЙСКОМ. А тут могут быть варианты?


ага, видали таких, в итоге программистам достался код с комментариями на хинди.

Я уже не говорю о том, что раскладку каждую секунду переключать неудобно.

Комментариев на русском явно не надо, ИМХО 

переменные и функции ты же русскими именами называешь?

по моему это неестественно  
комментарии - часть кода.

Это сообщение отредактировал(а) azesmcar - 16.11.2010, 18:10

Не озвученная глупость - не услышана.
Не написанная глупость - не прочитана.
Молчащий дурак - за мудреца сгодится.
Если ты собираешься презентовать свой исходный код, и не уверен в языке, лучше не комментировать вовсе.
ИМХО.

Добавлено через 6 минут и 38 секунд

Я, если комментирую, то только для себя.
Причем обычно постфактум. Когда разбирая свой код задаюсь вопросом "с какого бадуна я это накреативил". Разобравшись же, описываю мол "бадун был от того то, от тогото, по такому то поводу", чтоб второй раз думать не пришлось.

Добавлено через 7 минут и 49 секунд
ну или кода я сознательно не делаю чтото очевидно необходимое, имея в виду ......

Это сообщение отредактировал(а) Zloxa - 16.11.2010, 18:26

Вот, кстати, подумалось... а станет ли кто смотреть.
И если станет то - кто? HR? Директор IT? Начальник отдела? В пень бы оно им вдулось глазами парсить чужой ###код?

Хмм... по разному...
Например примечания к полям в *.mdb на русском (к сожалению внутрь базы позволино лазить конструкторам), в коде описание на английском (исключительно из-за ленивости переключать раскладку)
В тоже время оставляю каменты для себя, после end-а, что было сделано за последний билд на русском... Это помогает в последствии документацию на релиз составить - что изменено, добавлено, удалено...
Стараюсь обзывать процедуры/функции так, что бы они не нуждались в каментах, но если надобица, то на какой раскладке в данный момент нахожусь, на той и пишу ))) 

А по теме - у нас есть ЕСПД, по требованию которой все описания должны быть на русском языке...

Это сообщение отредактировал(а) ~FoX~ - 16.11.2010, 19:34

На русском, причём циклы оформляю вроде "начало выборки...кончало выборки".  

Это сообщение отредактировал(а) Данкинг - 16.11.2010, 19:59

Не согласен - коментарии полностью игнорируются компиляторами, поэтому они не являются частью кода.
Я бы сказал коментарии - это бонусная информация, чтобы можно было разобраться в своём коде после долгих праздников или когда твой проект кому-то резко понадобился, а тебе надо объяснить что там год назад ваялось и какой логикой при этом руководствовался.

[quote=DarkProg, 16.11.2010,  20:09, post2248678]Не согласен - коментарии полностью игнорируются компиляторами, поэтому они не 
Часть кода не означает, что она должна компилироваться. Каждая часть кода служит какой-то цели, что-то компилируется и выполняет действия а комментарии должны объяснять логику кода читающему.


а не доводилось работать в компаниях, где с кодом работает не один единственный человек, а несколько групп (причем из разных стран), а проект состоит из нескольких сотен мегабайт? Читаю ответы и такое ощущение, что код пишется исключительно для себя.  

я думаю лучше уж с ошибками, чем вообще без комментариев, но это мое мнение.


а зачем вообще нужны такие комментарии?

это и так из кода понятно, зачем повторяться в комментариях?

Так если конец цикла от начала отстоит на X строчек. Или несколько вложенных циклов.

можно выделять блоки другими средствами.. в том числе и пустыми строками..

Добавлено через 2 минуты и 8 секунд
а с русским всегда проблемы : кракозяблы из за несовпадения кодировок, либо читать трудно из за транслита..

Добавлено через 3 минуты и 18 секунд
а на английском  уже есть набор устоявшихся терминов.. поэтому даже по неполной фразе понятен смысл.. 

Всем спасибо, господа. Буду привыкать писать комментарии на английском   

  
Для написания комментариев на английском словарного запаса из 50 слов более чем достаточно. Что там? get, set, return, iterate, check, call ... и тому подобное, все техническое и давно знакомое даже тем, кто с английским не дружит.

Ну, по-моему, написанное всё же красноречивее, чем пустые строки.   

А зачем лезть в чужой код?
Я так полагаю, если идет коллективная разработка, то достаточно четко распределяются зоны ответственности. Разработчики друг другу выставляют интерфесы(функции там или классы), вот их описывать - обязательно. Особенно всякие ньюансики использования или же ограничения применения. Однако ж мне думается, описыать интерфес взаимодействия модулей предпочтительнее не коментариями в коде, а техническим дизайном и не по факту, а пре фактум. Тогда комментарий в коде выражается ссылкой на регламентирующий этот код документ, чего более чем достаточно.

Добавлено через 2 минуты и 26 секунд
Кстате, в делфийских сорцах VCL дофига коментариев?
Я ковырял ораклиные продукты. Их там тоже нет.

Мировой беспрактис, фигли!

иногда (иль даже часто) красноречие отвлекает.. 
комменты нужны для передачи смысла целого блока в одной строчке.. 
а дублировать строку плохой смысл..
т.е. такой код с комментариями

выглядит очень удручающе.. 

Это сообщение отредактировал(а) mes - 16.11.2010, 21:37

Вспомнил, в интерфейсной части - есть. Описание правил вызова. Я частенько туда смотрю.

mes, не просто "начало цикла", а "начало/конец заполнения таблицы TABLE", например.

Не все так идеально на самом деле. Иногда чужой код не работает, а хозяин находиться в другой часовой зоне или вообще уволился. А может его уже лет 10 как нету и этот код столько же лет не трогали, но вот сейчас понадобилось что-то в нем изменить.


кстати генерация этой документации может происходить на основе комментариев, для этого полно инструментов.


какая разница? лучше написать один комментарий, объясняющий логику работы цикла. Не забываем, что функция не должна состоять из 150-и строк, так что этого комментария будет вполне достаточно, не надо комментировать каждую строку. Если имя функции подобрано верно, комментарий объяснил логику работы то понять читающему всю логику функции не составит труда. Я никак не понимаю зачем писать что-то типа

?
и ежу понятно, что здесь возвращается x  зачем это писать? Тем не менее не раз встречал комментарии подобного рода.

Это сообщение отредактировал(а) azesmcar - 16.11.2010, 21:48

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

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

 
Ещё видел, что пишут так:
 

Это сообщение отредактировал(а) Данкинг - 16.11.2010, 22:34

Бредовые мысли всегда так легко узнаваемы по КАПСУ. Для русскоговорящего человека естественно использовать русский язык.


А не доводилось читать внимательно первое сообщение темы? Речь шла о маленькой локальной поделочке.


Читаю твои ответы и такое ощущение, что ты склонен обобщать собственный опыт. 


Ой да ладно!


Ещё можно не использовать языки в которых нужны какие-то сторонние средства выделения блоков.  


Нет уж, нафиг. Лучше кракозябры на русском/китайском/... .

можно.. но даже в обероне, если писать неаккуратно (не добавляя лишние пустоты для разделения) глаз будет напрягаться 
  

было б естественно, если б не было проблем вызванных русским языком.. 
к сожалению, развитость в этом направлении оставляет желать лучшего.. 
а так русскоязычному человеку, наверно, естественно программировать на русскоязычных ЯП..
только вот немногие позволяют себе это удовольствие 

Я думаю, что это сильно от контекста зависит, и в каждый случай нужно отдельно рассматривать исходя из того, кто этот код будет читать. Вот на фига мучать себя англицким, если 90% что читать будешь только ты? А те кто когда-нибудь и сунет нос в код, отлично понимают по русски? Если же ситуация другая, то тогда и смотреть нужно по другому.

А...ну да, конечно  
Русские комментарии, названия функций и переменных на русском..ведь это естественно. Жаль, что большинство компиляторов не поддерживают возможность писать полностью на русском и приходиться писать на транслите. А чтож ты на буржуйском пишешь? Ну создай свой язык и компилятор (полностью русский)..нечего буржуйскими пользоваться.


А не доводилось подумать о том, что все начинается с маленькой поделочки. Учиться надо делать правильно с самого начала. Это все равно, что сказать "программа маленькая", можно не заботиться о табуляциях и форматировании кода..и так все понятно.


Неверное ощущение. Это не только мой опыт, а опыт множества людей, с которыми я работал и общался. Я знаю немало людей, которые имели проблемы из за комментариев на другом языке кроме английского. Один пример я уже привел, еще одна проблема - кодировка. Ну и на мой личный опыт я считаю тоже можно сослаться (нескромен видимо).


Вот это шедевр  я просто в восторге  

Переведи фразу в верхний регистер, раз уж

выбирать язык исходя из этого...я даже не знаю что сказать 


Ты говоришь мучать - а я говорю писать на естественном для кода языке. Многие термины если и переводяться, то через одно место. Чего стоит "неуправляемый код"  и смотришь..вроде и правильно перевели, но звучит то как...
И не понимаю, почему многие считают это мучением? Неужели у кого-то настолько плохо с английским, что примитивный комментарий составить без труда не могут? Как же вы тогда вообще программируете?


  


Ну если твоя конечная цель - это "лишь бы мне было удобно" тогда понятно.

Это сообщение отредактировал(а) azesmcar - 17.11.2010, 08:22

как ловко ты передергиваешь  вроде только о комментариях говорят.



А если в комментариях нужно использовать термины из предметной области, то что делать? И все спецы по ней только на русском и разговаривают?  Тут как бы, ситуация обратная получается.

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




Это сообщение отредактировал(а) Sibit - 17.11.2010, 10:26

Кстате, это один из случаев, когда, с моей точки зрения коментарии следует писать обязательно.
Когда в коде вводится именование сущности,  отличное, от именования, определенного в регламентирующем документе.

Из недавних примеров: в дизайне написано "Ограничивающий список", в коде написано "Rstrct_lst"

А почему собственно нет? Какой смысл называть функцию английским именем? Я например не вижу разницы. Если человек сложно в двух словах описать поведение функции на английском у него будут те же сложности с подбором имени. Я в упор не вижу разницы. Допустим в каком-то языке программирование разрешается называть функции русскими именами. Так и будете делать?

что-то вроде этого...


что-то я не пойму как тогда эти спецы называют свои функции, переменные, программируя в этой самой предметной области. Мне не знакома область, в которой термины были бы известны большинству на русском и не были бы известны на английском. Подавляющее большинство терминов взяты из английского. Если вы пишите слово инкапсуляция на русском, это не значит, что это слово русское.


Если ситуация сегодня позволяет писать комментарии на русском, завтра ситуация может кардинально измениться и если ты не встречался с такими ситуациями, это не значит, что их не существует. Компании имеют свойство расширяться, более того, в этом весь смысл бизнеса. Открываются филиалы в других странах, иностранные работники, может быть оутсурс некого модуля в другую страну..Если каждый будет писать комментарии так, как ему удобно в итоге получиться бардак и возникнут проблемы. Надо будет все переписывать, так почему бы не положить правильное начало? Или уже с первых строк кода команда не надеется на то, что этот проект станет чем-то стоящим и компания разрастется?


можно было нормально написать и никаких проблем  

Это сообщение отредактировал(а) azesmcar - 17.11.2010, 11:02

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

я имел ввиду написать не Rstrct_lst а restricted list и все было бы понятно.

оки.
Однако же есть еще проектный ограничивающий список. И у него есть детали и по ним должна вестись история
Тогда история деталей проектного ограничивающего списка как, по твоему, должны звучать?
restrict_list_draft_details_history?
Ах, да, забыл еще упомянуть об ограничении 30 символов для именования сущностей в оракле.

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


Как по английски будет ЕНВД?
Как по агнлийски будет НДФЛ, БИК, ИНН,НДС,ЕРГЮЛ?
Уверен, подавляющее большинство затруднится перевести эти понятия.
Хорошо если многие смогут раскрыть эти аббревиатуры.

Это сообщение отредактировал(а) Zloxa - 17.11.2010, 11:23

Ну-ну, не все так плохо   

С названием методов и т. п. проблем особых нет. Речь с самого начала шла именно о комментариях, как о предложениях, грамотных с т. з. грамматики английского языка. Цитирую топик:

Небольшой пример. 
По-русски: "подключение внутреннего номера к внешней линии". Какой-то линии к какому-то номеру.
Перевод: "connecting internal number to external line" с артиклями писать или без? Т. е. "connecting an internal number to an external line". По правилам, вроде, с артиклями. А последние тенденции технического письма говорят об обратном.

Как правильно-то?   

Кстати, нет. Я не знаю языка 1C, но видел куски кода на оном, и они на меня производят удручающее впечатление. А комментарий - ну действительно, если для меня родной язык русский, и программу я пишу точно не для M$, так зачем вместо "начало проверки по дате" я буду писать "here comes the date checking"?

Добавлено через 59 секунд

Я бы без артикля оставил, чисто на интуитивном уровне.

Пунто свичер регулярно спасает отца русской демократии.



Сдается мне, что это будут комментарии в стиле Капитана Очевидность.



А потом разработчик уходит и на его место берут другого.


Нет, не дофига, потому что разработчики решили, что 
И тут я с ними согласен.

А почему никто не рассмотрел такую ситуацию. Пишет команда код, а английский все знают с пятого на десятый. И тут приходит в команду мегагуру, которого научили "писать комментарии на правильном языке". Вся команда дружно пошла на курсы английского...

У меня, например, нет никаких иллюзий: я не написал еще ничего такого, что когда-либо будут читать нерусскоязычные разработчики. Нафига мне корячиться?
Я считаю, что достаточно вместо 
писать

Что я и делаю, ибо читать транслит - удовольствие ниже среднего.

А по поводу комментариев я исповедую концепцию самодокументирующегося кода.

Это сообщение отредактировал(а) RockClimber - 17.11.2010, 11:42

Комментарии исключительно на русском. На счет кодировки это унылое нытье тех кто не сумел нормально настроить свою среду, более того все чаще исходники сохраняются в uft8, так что проблем с языком быть не должно.
  Безусловно зависит от того кто будет читать эти комментарии. Свои комментарии в большинстве случаев читаю только я, поэтому делаю их так как мне удобно. В ближайшее время не предвидится, что их будет читать кто-то не владеющий русским.

Добавлено через 53 секунды

  Нереально использовать в программировании, потому что сбивается на каждом слове. 

я бы написал this function connects described internal nubmer to the external line 

Это сообщение отредактировал(а) Zloxa - 17.11.2010, 12:02

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

Например,  в англицком букв меньше.


Например бухучет, торговля и другие прикладные области. Вот например, "Чересполосно-постепенные лесосеки" как это на английский переводить, и главное - зачем?


Спецы , в данном случае ничего не называют, он ставят задачу программистам и используют их результаты.



Может измениться, а может и не измениться. Я вот уверен, что контора, где я работаю, никогда не будет иметь филиалов за рубежом. Компании они разные и ситуации они тоже разные. Например, вокруг меня в окрестности 700 км 95% населения использует русский. 

Вообще непонятно, с чем ты споришь, считаешь, что все коменты надо на английском писать? Так с этим лучше к 1С-никам, вот там от души похоливарить можно.   

вопрос поставлен очень не понятно

если комьюнити - это 80-90% разработчиков с Азии и с Америки и если вы берете все классы с этого комьюнити или по примеру ихнего кода пишете, то зачем писать комментарии на русском? (чтобы потом все равно перевести на английский  )

если например, Tatsuhiko Miyagawa и Kazuhiro Osawa  начнут писать на японском, то как вы будите все это переводить?

Это сообщение отредактировал(а) gcc - 17.11.2010, 13:17

Да какая разница? Ты же не сочинение пишешь, главное смысл передать.


согласен  


я как раз писал о ненужности комментарий такого рода, а предложение все равно составляется в основном из этих слов.


А ты видимо всегда сам настраиваешь свою среду? И сервера компании...итд?


Я даже на русском не понял что ты сказал, какой мне толк от таких комментариев?


именно так  


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


а я не холиварю, я выражаю и обосновываю свое мнение. С противоположной же стороны лишь вижу обоснования типа "я русский, мне так удобнее". Т.е. опять таки забота о самом себе, но напомню (так, на всякий случай), что комментарии пишутся не только для себя. Если вы пишите программу у себя на компьютере и никого на свете она не касается и не интересует то пишите хоть на китайском, кого это волнует? Я лишь говорю о том, как на мой взгляд правильнее с точки зрения программирования.


Я приведу причины
1. Проблемы с кодировкой
2. Неудобно переключать раскладку
3. Код делается понятным только русскоязычным программистам
а какая причина (кроме "мне так удобнее") для написания на русском? Т.е. я хочу понять ради чего ставить себя в какие-то рамки?

А то основываясь на "мне так удобно" можем дойти до того, что и форматировать код не нужно, табуляции не нужны..зачем это все? Мне же и так удобно (а мне действительно когда-то на первом курсе так было удобно).


Это сообщение отредактировал(а) azesmcar - 17.11.2010, 13:31

  А каким боком сервера компании связаны с твоим исходным кодом? 


  Если писать опенсорс, то может это и важно. 

ну иногда программисты компилируют свой исходный код на серверах компании..отлаживают, проверяют профайлерами..  

Конечно Английский ! О чём вообще речь ?

Или вы хотите прям матом комментарии писать и программа - это калькулятор ?

Так и я оп том же, комменты пишут для того кто их будет читать. И если у меня этот термин используется, то что мне по-твоему делать?



Неправильно, читать будут только те кто понимает по-русски гораздо лучше, чем по-английски.


А когда для 1С пишешь что-то, то что делать?


И многие из них правы.

В общем, существуют сферы, где писать комменты на английском - глупо. Несогласен?

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

Я говорю, что мне этот комментарий что на русском, что на английском ничего не говорит, какой смысл от него? Лучше опиши что функция делает.


Возможно я задену чьи-то чувства, но 1С я за полноценное программирование не считаю. Там сам скрипт насколько я знаю на русском и шанса, что с ним будет работать человек, не знающий русского языке практически нет.


Я не представляю что человек, который не способен понять простую фразу на английском делает в программировании.


Если эта сфера - 1С то я согласен 


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

У нас вообще во многих компаниях бесплатные курсы английского языка проводят за счет рабочего времени.


Это сообщение отредактировал(а) azesmcar - 17.11.2010, 14:04

  Осталось маньяка убийцу научить инглишу на таком уровне, чтобы он осилил твои коменты раньше чем возжелает найти тебя  Часто и на русском не все понятно.

Нет ) Ну а почему тогда не матом ? м ?

а если маньяк не шпрехен по русски?

  Уже говорилось, что коменты должны быть на том языке которым будет владеть их читающий или инглиш если читать будут несколько разных людей.
  Чего бы ты не говорил, но лучше чем на родном языке ты не сможешь изъясняться, особенно когда нужно писать более чем 3 слова. 

Я и говорю о том, что никогда не знаешь кто потом будет их читать. А если тебе плевать - тогда зачем их вообще писать с такой заботой

?

Ладно, неохота больше спорить..вот попадет вам в руки код с комментариями на хинди, тогда вспомните мои слова  

Как раз строит такую лесосеку, или отчет по ним делает, а есть еще функция которая строит совсем другую лесосеку, а еще есть отчет, который делается по определенным лесосекам. Это я все к тому, что если писать на нерусском, то получатся не комментарии а вольное словотворчество, которое невозможно будет прочитать. И если в случае с нормальным русским текстом есть возможность спросить у того кто знает, что это такое, то в случае с нерусским, вообще непонятно как читающий это переведет.


Ок. А если проект не на 1С, но из сферы бухучета и всяких там налогов. Как быть? Появляются там в коменнтах всякие ЕНВД, НДС, НДФЛ и прочая... Писать термины на русском, а все остальное на нерусском?



Лично я, говорю по-русски лучше чем по-английски. И большинство из здесь присутствующих, я думаю, тоже.


Когда как. Иногда ранглиш гораздо хуже транслита.

комментарии на английском.
но, к примеру, объемный "TODO:" пишу на русском из-за ограниченного словарного запаса англ. языка.

Добавлено через 3 минуты и 25 секунд

видал я однажды комменты на молдавском. это страшно  

Я не знаком с этими терминами, не могу сказать как написать, но к примеру НДС переводиться довольно просто - VAT. 
А как ты назовешь скажем функцию, считающую НДС? CalculateNDS? Если NDS - понятный термин то так и пиши в комментариях, в чем проблема? Ты же вроде согласился, что имена функций и переменных надо называть на английском. Вот как функцию и переменную назвал - так и пиши в комментариях.
К тому же большинство бухгалтерских терминов пришли опять таки из английского. Дебит, кредит, баланс...


Я тоже, но это никак не мешает мне читать и понимать простой текст на английском не хуже, чем на русском.


Это сообщение отредактировал(а) azesmcar - 17.11.2010, 14:30

Топикстартер принял решение комментировать свой код для портфолио.
Коментарии с ошибками в портфолио, ИМХО нанесут больший имиджевый ущерб нежели отсутствие комментариев вовсе.

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

Это сообщение отредактировал(а) azesmcar - 17.11.2010, 14:33

  Не хуже чем на итальянском или на французском. Не для тебя предназначался текст. Что в этом такого? Глупо писать на английском, при том, что вероятность их прочтения не знающим языка порядка 1%. Можно понять английские коменты, когда такая вероятность что их будут читать не владеющие языком 20-30% и более.

а, я вот призадумался.
Для телефонии более уместен бы был термин link нежели connect....

Кстати о телефонии. Мне както довелось рыть документацию, написанную по английски франкоговорящими канадцами. Это был пэпэцэ!
Только на середине документа я понял что "this end", "those end" обозначает локальный и удаленные трансиверы. Пришлось, постигнув эту истину перечитывать ту феерическую бредятину сызнова. Там было еще множество перлов, которые меня, человека плохо дружащего с английским, но постоянно работающим с англоязычной литературой, просто вгоняли в ступор и недоумение, не проясння общую картину а обфусцируя ее.

Это сообщение отредактировал(а) Zloxa - 17.11.2010, 15:04

А какие проблемы могут быть, если проект будет открываться в той же среде?

Что-то я сомневаюсь, что у программиста может вызывать неудобство переключение раскладки.  Может, тогда и сообщения программы писать латиницей, вроде "Rabota okonchena!"  

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

А кому удобно переключать раскладку? Тем более, если языков больше двух, думай ещё сколько раз кнтр+шфт нажать

Я вот, к примеру, всегда знаю на какой язык переключаюс

А мне так не удобно. Несколько раз так ставил, но не могу привыкнуть.

Если не можешь привыкнуть, действительно остается всякий раз думать.   

Это сообщение отредактировал(а) Zloxa - 18.11.2010, 16:47

мне бы три кнопки на клаве, (en, ru, ua)   

http://dictionary-economics.ru/word/%D0%94...%B1%D0%B5%D1%82
  

Это сообщение отредактировал(а) mes - 18.11.2010, 18:16