Новая справка по QSP.

Re: Новая справка по QSP.

Nex написал(а):

Угу, давайте вместо "джинсы" и "брюки" говорить "штаны из джинсовой ткани" и "штаны не из джинсовой ткани". Так всем понятнее будет!

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

P.S. Брюки из джинсовой ткани тоже бывают.

newsash
useravatar
Offline
465 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Re: Новая справка по QSP.

newsash,
ты пытаешься выдумать новую терминологию. Прекрати.

Особенно начинающие авторы, для которых это первое общение с программированием.

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

А нормальных программистов своей навязанной терминологией ты будешь только отпугивать. "Как у вас тут функцию сделать?" "Стоп, какую ещё функцию? Может ты имел в виду ПОДПРОГРАММУ ВОЗВРАЩАЮЩУЮ ЗНАЧЕНИЕ?"

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

Nex
useravatar
Offline
4277 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Re: Новая справка по QSP.

В общем, у меня GS - обработка локации, FUNC - обработка локации с возвращением значения. Вводить в эти формулировки дополнительные термины я смысла не вижу. Поэтому речь идёт только о названии статьи и кусочке текста в статье про локации.
На данный момент в статье про локации есть "локации с кодом" и "локации-функции", соответствующая статья называется "пользовательские функции и процедуры". Причём слово "процедуры" по всей справке используется только в названии этой статьи.
Второй вариант, который был предложен:
Будут "локации-подпрограммы", которые "могут как просто выполняться, так и возвращать значение" (формулировка обсуждаема). Статья будет называться "Работа с подпрограммами".

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

P.S. И есть желание заменить фразу "возвращает значение" на более понятную не программистам. Этот оборот многократно используется в справке.

UPD: По последнему сообщению: возможно, ты прав. Но необходимость в процедурах возникает как только автор перестаёт играться и осваиваться и хочет написать нормальную интересную игру.

newsash
useravatar
Offline
465 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Re: Новая справка по QSP.

>P.S. И есть желание заменить фразу "возвращает значение" на более понятную не программистам. Этот оборот многократно используется в справке.
Нужно на примере про показать что есть "возвращает значение", чтобы стало понятно.

Flashback
useravatar
Offline
34 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Re: Новая справка по QSP.

Flashback написал(а):

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

Везде, где они не забыты, примеры есть.

newsash
useravatar
Offline
465 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Re: Новая справка по QSP.

Причём слово "процедуры" по всей справке используется только в названии этой статьи.

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

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

Без этого объяснения статья почти бесполезна, каким заголовком её не обзови. А в объяснении всё равно придётся внятно делить подпрограммы по предназначению. Внятно обязательно, потому что по-другому информация не запомнится. Так что в итоге придётся либо вбивать в голову автора лишний термин "подпрограмма", либо делать вид что "процедур" и "функций" не существует. И каждого новичка, который в учебнике или в обсуждении на форуме увидит слово "процедура" и спросит "что это, в справке этого нет", я буду отправлять за разъяснениями к тебе лично.

Nex
useravatar
Offline
4277 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Re: Новая справка по QSP.

Nex написал(а):

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

Если я правильно пользуюсь поиском, то на форуме слово "процедура" за всю историю использовалось от силы в десятке постов четырьмя-пятью людьми включая нас с тобой. Так что я не против.

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

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

newsash
useravatar
Offline
465 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Re: Новая справка по QSP.

newsash написал(а):

Flashback написал(а):

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

Везде, где они не забыты, примеры есть.

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

Flashback
useravatar
Offline
34 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Re: Новая справка по QSP.

newsash,
разница есть, не нужно загромождать справку высосанными из пальца понятиями.

Это только кажется что знать "что такое подпрограмма" очень нужно и полезно. Мой коллега, высокооплачиваемый программист с более чем десятилетним стажем ничего не знает о "подпрограммах" и ему это никак не мешает. Это понятие упоминается только в учебниках, чтобы объяснить и тут же забыть. Нужно ли это в справке?

Более того, многие, включая составителей учебников, путают понятия и обозначают "подпрограмма"="процедура", тем самым противопоставляя подпрограммы и функции. В Бейсике, по мотивам которого был создан язык QSP, и того хуже: оператор GOSUB расшифровывается как Go Subroutine, а слово "Subroutine" и есть "подпрограмма"! Что далеко ходить за примером, если даже ты путался пару сообщений назад. Да и в других темах на нашем форуме в таком ключе упоминается.

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

Nex
useravatar
Offline
4277 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Re: Новая справка по QSP.

Nex написал(а):

Это понятие упоминается только в учебниках, чтобы объяснить и тут же забыть. Нужно ли это в справке?

Ответ <- вопрос.

Nex написал(а):

Нужна ли вся эта терминологическая каша в справке? По-моему, ответ однозначен.

На мой взгляд процедуры и функции - лишнее разделение в принципе. Попробуй найти на википедии статью про процедуры.
Диалог с коллегой - "А в каких языках есть разделение на функции и процедуры?" - "А что это такое? Это которые ничего не возвращают?" - "Ага." - пауза - "Фиг знает. В Бейсике может."

Ну ладно, придётся оставить. Попробую подговорить Байта объединить эти два оператора.

newsash
useravatar
Offline
465 Сообщений
Информация о пользователе в сообщениях
Администратор отключил публичную отправку сообщений

Информация

Статистика форума:
 
Всего тем:
981
Всего опросов:
14
Всего сообщений:
16790696
Всего сообщений сегодня:
1
Пользователи форума:
 
Всего пользователей:
2419
Последним зарегистрировался:
silviel