Нормативный документ с указанием "как именовать объекты"

← →
YurikGL © (2008-05-29 13:07) [0]

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

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

← →
tesseract © (2008-05-29 13:08) [1]

> что "некорректно именовать разные объекты именами, которые
> не отражают различия между объектами."

Логика. Учебник для вузов.

← →
Умище (2008-05-29 13:15) [2]

> "Журнал входящих документов" и "Журнал регистрации входящих
> документов",

Разные вещи-)

← →
Ega23 © (2008-05-29 13:34) [3]

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

Нигде таких документов нет. Всё регламентируется соглашением о наименованиях, принятых в конкретной компании под конкретный проект. В одном месте юнит с маленькой буковкой u принято сохранять. В другом - без. В одном TfrmAction = class (TForm), в другом - TActionForm = class (TForm).

← →
User_1 (2008-05-29 13:38) [4]

> Ega23 © (29.05.08 13:34) [3]

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

← →
Ega23 © (2008-05-29 13:41) [5]

> О соглашениях тоже хотелось бы почитать, есть ли единые
> соглашения (вообще по оформлению кода) и если есть то где
> можно ознакомиться ?

Где-то был интересный документ, там, типа, всё по полочкам разложено, вплоть до оформления кода:

if ... then begin end

или
if ... then begin end;
или

if .. then begin end;

Погугли, у меня его не осталось, коллега по бывшей работе приносил как-то.

← →
Правильный+Вася (2008-05-29 13:42) [6]

> "Журнал входящих документов" и "Журнал регистрации входящих
> документов"

дык, в одном сами документы, а в другом информация об их поступлении
это как ты и твой паспорт

← →
123-ий номер (2008-05-29 13:58) [7]

> Ega23 © (29.05.08 13:41) [5]

читал я эту статейку на королевстве. ИМХО очень полезно

← →
DVM © (2008-05-29 14:25) [8]

http://www.delphikingdom.com/asp/viewitem.asp?catalogid=802

← →
123-ий номер (500) (2008-05-29 14:30) [9]

она

← →
YurikGL © (2008-05-29 15:09) [10]

> дык, в одном сами документы, а в другом информация об их
> поступлении
> это как ты и твой паспорт

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

← →
YurikGL © (2008-05-29 15:12) [11]

Речь идет больше об интерфейсе. Или, если точнее, о надписях на контролах.
В частности, мне припоминается, что на кнопках желательно писать глагол, отображающий действие, а не существительное. Т.е. писать не "Выход" а "Выйти".

← →
Ega23 © (2008-05-29 15:15) [12]

"Отмена" - это глагол?

← →
YurikGL © (2008-05-29 15:17) [13]

> "Отмена" - это глагол?

Неа.. правильно "Отменить"

← →
Правильный-Вася (2008-05-29 15:31) [14]

> на кнопках желательно писать глагол, отображающий действие,
> а не существительное

Билли про кнопку "пуск" скажи

← →
YurikGL © (2008-05-29 15:37) [15]

> Билли про кнопку "пуск" скажи

А Start, разве не глагол?

Есть что по сабжу?

← →
Ega23 © (2008-05-29 15:41) [16]

> Неа.. правильно "Отменить"

А вот диалоги в XP мне другое говорят.

← →
MsGuns © (2008-05-29 16:21) [17]

Единого правила как НАДО называть объекты быть не может, а вот как НЕ НАДО пожалуйста:
http://delphimaster.net/view/3-1212053897/

Я подсмотрел когда-то у Тексейры такую схему
<тип/класс объекта><Имя логически связанного объекта или блока объектов><Имя объекта>
Например:

(для TAction)
actViewSort, actViewSortDesc, actViewRefresh
actEditInsert, actEditModify, actEditCancel

(для TEdit)
edDocTitleNum, edDocTitleDate, edDocTitleSender - заголовок док-та
edDocStockCode, edDocStockName, edDocStockPrice, edDocStockQuont - фактур-строка

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

По поводу кнопки
http://www.mgopu.ru/ininfo/ATLAS/tech_h04.htm

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

По сабжу - начинаю бить разработчика CUA Common User Access

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

Я вот везде вижу "OK" и "Отмена".

>[19] Ega23 © (2008-06-03 16:04:00)
а что поделаешь, если переводчики — обезьяны?

---
Understanding is not required. Only obedience.

> а что поделаешь, если переводчики — обезьяны?

гм...
Прикинь, "Виста в переводе Гоблина"? :)))

← →
Правильный_Вася (2008-06-03 17:07) [22]

> > Билли про кнопку "пуск" скажи
> А Start, разве не глагол?

не надо подменять понятия
"пуск" - существительное
и переводчики тоже у Билли работают

> Я вот везде вижу "OK" и "Отмена".

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

Да ты - разработчик интерфейса :)))

>[22] Правильный_Вася (2008-06-03 17:07:00)
«пуск» — существительное. а «start» может быть и глаголом. и должно, собственно. но переводчики у билли тоже индийцы, увы.

---
All Your Base Are Belong to Us

Нормативный документ с указанием "как именовать объекты" Найти похожие ветки