The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]



"Выпуск раскладки клавиатуры Ручей 1.4, упрощающей ввод спецсимволов "
Версия для распечатки Пред. тема | След. тема
Форум Разговоры, обсуждение новостей
Исходное сообщение [ Отслеживать ]
Подсказка: Для контроля за появлением новых сообщений - перед выходом жмите "Пометить прочитанным".
. "Выпуск раскладки клавиатуры Ручей 1.4, упрощающей ввод спецс..." +/
Сообщение от 6ap (ok), 03-Сен-22, 21:52 
Для международных проектов это скорее всего утверждение верно, но для какой-либо отрасли в рамках СНГ нет.

У нас в компании принято писать комментарии к коду на русском. Комментарий не является переводом названия метода на русский, а достаточно расширенно говорит что этот метод делает. Например метод rpnUp имеет комментарий "Переключает ступень РПН для регулирование напряжения трансформатора", комментарий к int num - "Номер ступени трансформатора от 0 до 10". Далее на основе этих комментариев формируется самодокументированное API, где эти комментарии очень важны т.к. пользователь этого API не сможет заглянуть в код.

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

Ответить | Правка | Наверх | Cообщить модератору

Оглавление
Выпуск раскладки клавиатуры Ручей 1.4, упрощающей ввод спецсимволов , opennews, 02-Сен-22, 21:59  [смотреть все]
Форумы | Темы | Пред. тема | След. тема



Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру