Вопрос к Игорю Ткачеву, как основному разработчику данного продукта.
Игорь есть что либо по русски для ознакомления с библиотекой?
К сожалению весь код документирован по английски и это затрудняет понимание целей кода! И даже сам сайт на английском, такое впечатление, что автор решил поупражняться в знании английского языка.
Представьте русский человек выражает русские мысли на чужом английском языке, потом русский человек читает английский текст и пытается перевести его на русский, чтобы понять, а что собственно хотел сказать архитектор кода!? Получается испорченный телефон, так как после такого перевода как минимум 30% мыслей теряется, а в некоторых случаях и более.
Да и честно говоря за державу обидно! Русские люди, а выражают свои мысли по английски.
Если бы код был документирован по русски, то вполне возможно, что и документация не потребовалась бы.
Ведь что получается, мы облегчаем анлоязычным людям пользоваться нашими разработками и паралельно "закрываем к ним доступ" русскоязычным.
Продукт ведь бесплатный! Зачем писать коменты на анлгийском? Какая великая цель преследовалась?
На мой взгляд, если разработчик изначально хотел донести свои мысли до своих коллег разработчиков (русских конечно), то и следовало писать комментарии по русски!!! А так получается, что мы сами органичиваем доступ к продукту для российских разработчиков.
Вообщем есть предложение перевести все коменты на русский язык и это и будет документация (можно использовать SandCastle для получения chm)!
А в примерах (testunit) описать по русски, что тестируется и как.
Этого должно хватить, чтобы библиотекой начали пользоваться русские люди.
Я например, если и пытаюсь использовать англоязычные source проекты, то всегда пытаюсь их задокументировать по русски, если же не удается понять, что хотел архитектор, то ищу другого...
Данный продукт очень интересен мне, поэтому я обратил на него внимание, однако как всегда меня очень удивляет настойчивое желание русских людей изъясняться по английски!!!
Ведь английских людей не тянет почему-то писать по русски или на другом языке... они пишут на своем языке, так им легче и удобнее, так неужели нам русским людям приятнее и удобнее писать на чужом английском языке!!!
G>Да и честно говоря за державу обидно! Русские люди, а выражают свои мысли по английски.
Обидно, когда по телевизору говорят "креатив" или "сейл". Или когда на вахте работы висить мери крисмас. А вот когда в коде комментраии написаны на аглийском, совершенно необидно.
Комментарии на английском получаются короче (раз), не требует переода терминов (два, тот же theard он везде thread, а не нить/поток о котором тут же могут начать спорить), получается более локаничный и выразительный (три)
Коли уж ты выбрал профессию программиста, _учи_ английский язык. А то вот сейчас медики начнут плакаться, что же вы в книжках то всё на латыни да на латыни, за держвау обидно.
Здравствуйте, grufos, Вы писали:
G>Вообщем есть предложение перевести все коменты на русский язык и это и будет документация (можно использовать SandCastle для получения chm)! G>А в примерах (testunit) описать по русски, что тестируется и как.
ну вот, можете сделать всем добряк
напишите эту документацию, вам все спасибо огромное скажут.
а игорь, он так-то живет и работает в америке, и BLT пользует в своей реальной работе, так что русский язык в комментариях ну никак не укладывается.
G>Этого должно хватить, чтобы библиотекой начали пользоваться русские люди.
знание языка английского для программиста русского есть насущная необходимость. так что рассмотрите все это как лишний повод попрактиковать язык
Здравствуйте, ili, Вы писали:
ili>напишите эту документацию, вам все спасибо огромное скажут.
Несомнено, я так и буду поступать, только ведь переводить я буду только те участки с которыми буду сам сталкиваться в работе. Библиотека велика и не все ее части мне требуются. В данном случае хотелось найти людей также заинтересованных в подобном процессе. У меня, также как навернео и у всех, не так много времени которое я мог бы потратить на эту работу, поэтому в целом это может быть выполнена только общими усилиями.
ili>а игорь, он так-то живет и работает в америке....
тогда все понятно с английскими комментариями, в данном случае я тоже писал бы на английском.
ili>знание языка английского для программиста русского есть насущная необходимость. так что рассмотрите все это как лишний повод попрактиковать язык
Несомненно, практика лучший учитель. Именно так я и поступаю, однако несмотря на умение читать технический текст на английском, я очень люблю свой родной язык. На данный момент я предпочитаю читать доки по русски, если есть такая возможность
Например, сообщество www.foxclub.ru на самостаятельных началах общими усилиями выполнили перевод документации по продукту Visual FoxPro 9.0 на русский язык. Молодцы ребята.
Здравствуйте, grufos, Вы писали:
G>есть что либо по русски для ознакомления с библиотекой?
почти два года назад IT время от времени развлекался написанием факов. Они доступны здесь. Более новая информация на форуме и в коде.
Здравствуйте, grufos, Вы писали:
G>Здравствуйте, ili, Вы писали:
ili>>напишите эту документацию, вам все спасибо огромное скажут. G>Несомнено, я так и буду поступать, только ведь переводить я буду только те участки с которыми буду сам сталкиваться в работе. Библиотека велика и не все ее части мне требуются. В данном случае хотелось найти людей также заинтересованных в подобном процессе. У меня, также как навернео и у всех, не так много времени которое я мог бы потратить на эту работу, поэтому в целом это может быть выполнена только общими усилиями.
с миру по нитке... чего-то вы напишите, потом кто-то еще дополнит....
только суть в том, что все это не в коде должно быть, а в доке рядом
Здравствуйте, grufos, Вы писали:
G>Игорь есть что либо по русски для ознакомления с библиотекой?
По-русски мало.
G>К сожалению весь код документирован по английски и это затрудняет понимание целей кода! И даже сам сайт на английском, такое впечатление, что автор решил поупражняться в знании английского языка.
Сайт нужен для того, чтобы когда спрашивали "что это такое и где взять", то было куда отсылать. Что касается английского языка, то комментариев в коде на столько не много, что на аглийском они или на русском рояли не играет. Вообще, мы старались сделать код самодокументируемым, т.е. имена классов и методов тщательно выверяються. Переводить же идентификаторы на русский никто по понятным причинам не будет.
... << RSDN@Home 1.2.0 alpha rev. 717>>
Если нам не помогут, то мы тоже никого не пощадим.
Любителям писать код на русском языке могу посоветовать "поиграться" с 1С бухгалтерией. Через час-полтора возникнет конкретная ностальгия по "нормальным" (англоязычным) языкам программирования.
Здравствуйте, _Budda_, Вы писали:
_B_>Любителям писать код на русском языке могу посоветовать "поиграться" с 1С бухгалтерией. Через час-полтора возникнет конкретная ностальгия по "нормальным" (англоязычным) языкам программирования...
согласен... через час-полтора возникнет... но, когда набрав опыта и уже не игрясь и играючи создавая конфы для 1С, вдруг возникнет необходимость написать что-то "бизнес-коммерческое" в англоязычной среде начнешь задумываться — как обозвать по-ангельски какую-нить ТТН... или ПКО....
Если нам не помогут, то мы тоже никого не пощадим.
