Forth и другие саморасширяющиеся системы программирования Locations of visitors to this page
Текущее время: Вт дек 11, 2018 09:01

...
Google Search
Forth-FAQ Spy Grafic

Часовой пояс: UTC + 3 часа [ Летнее время ]




Начать новую тему Ответить на тему  [ Сообщений: 5 ] 
Автор Сообщение
 Заголовок сообщения: соглашения по оформлению кода
СообщениеДобавлено: Чт июн 25, 2015 16:00 
Не в сети
Moderator
Moderator
Аватара пользователя

Зарегистрирован: Чт май 04, 2006 00:53
Сообщения: 4956
Откуда: был Крым, теперь Новосибирск
Благодарил (а): 18 раз.
Поблагодарили: 56 раз.
Имхо, достаточно важный вопрос по поводу соглашений оформления кода.
Предлагаю за основу взять соглашения по оформлению кода из форка и откорректировать до приемлемого участниками состояния.
обсуждение в тему

_________________
Мне бы только мой крошечный вклад внести,
За короткую жизнь сплести
Хотя бы ниточку шёлка.
fleur


Вернуться к началу
 Профиль Отправить личное сообщение  
Ответить с цитатой  
 Заголовок сообщения: Re: соглашения по оформлению кода
СообщениеДобавлено: Чт июн 25, 2015 17:34 
Не в сети
Administrator
Administrator
Аватара пользователя

Зарегистрирован: Вт май 02, 2006 22:48
Сообщения: 6452
Благодарил (а): 14 раз.
Поблагодарили: 101 раз.
Мне это видится практическим примером конкретных правил, которые опять же не стоит жестко фиксировать. Стиль оформления кода должен быть. Просто он не должен быть каким-то конкретным. В приведенной ссылке я увидел несколько устаревших технически вещей (например, кодировка DOS, символ конца файла, 80 символов в строке). Кроме того, лично я собираюсь понемногу отказываться и от некоторых форт-соглашений старого стиля. Например, круглые скобки как комментарий. Для меня это выглядит как старая-старая красная тряпка, которой когда-то "поддразнивали" программистов, спрашивающих, где же скобки. Однако же это не догма, которой я призываю следовать, а возможная альтернатива. Мне вот сейчас интересно, каким образом сможет существовать проект, собранный из альтернатив :)


Вернуться к началу
 Профиль Отправить личное сообщение  
Ответить с цитатой  
 Заголовок сообщения: Re: соглашения по оформлению кода
СообщениеДобавлено: Чт июн 25, 2015 18:22 
Не в сети
Moderator
Moderator
Аватара пользователя

Зарегистрирован: Чт май 04, 2006 00:53
Сообщения: 4956
Откуда: был Крым, теперь Новосибирск
Благодарил (а): 18 раз.
Поблагодарили: 56 раз.
Hishnik писал(а):
Мне это видится практическим примером конкретных правил, которые опять же не стоит жестко фиксировать.

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

Hishnik писал(а):
Стиль оформления кода должен быть. Просто он не должен быть каким-то конкретным.

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

Hishnik писал(а):
Например, круглые скобки как комментарий.

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

Hishnik писал(а):
В приведенной ссылке я увидел несколько устаревших технически вещей (например, кодировка DOS, символ конца файла, 80 символов в строке).

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

Hishnik писал(а):
Мне вот сейчас интересно, каким образом сможет существовать проект, собранный из альтернатив :)

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

_________________
Мне бы только мой крошечный вклад внести,
За короткую жизнь сплести
Хотя бы ниточку шёлка.
fleur


Вернуться к началу
 Профиль Отправить личное сообщение  
Ответить с цитатой  
 Заголовок сообщения: Re: соглашения по оформлению кода
СообщениеДобавлено: Чт июн 25, 2015 19:29 
Не в сети
Administrator
Administrator
Аватара пользователя

Зарегистрирован: Вт май 02, 2006 22:48
Сообщения: 6452
Благодарил (а): 14 раз.
Поблагодарили: 101 раз.
mOleg писал(а):
имхо, стоит договориться о минимальном достаточном наборе правил, иначе бардакс...

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

mOleg писал(а):
Должен быть конкретным, впрочем, тут можно провести голосование.

На практике, такие голосования реально работают только при 100% голосов, отданных за очевидный и понятный всем вариант. Иначе проще сказать "хорошо, делаем как умеем, только документируем".

mOleg писал(а):
а что взамен? К тому же круглые скобки не обязательно для коментария использовать, можно и более сложным образом, скажем, для именования переменных и обращения к ним по имени (аки локальные переменные)

Конкретно у меня сейчас работают \ и //. Многострочных комментариев нет по другим соображениям (здесь аргументация из Ada/VHDL). Но это пример. Вот мне не нравится так. Кому-то хочется еще как-то. Таких вопросов будет достаточно много, и важно не делать их камнями преткновения. Не все такие вещи одинаково критичны для Форта и не все критичны для соблюдения авторами.

mOleg писал(а):
мне тоже достаточно интересно, но такой проект должен быть тщательно распланирован, чтобы не оказаться гарантированным фиаско

"Распланирован" <> "навязано ТЗ". Факт: навязанное ТЗ при свободном участии не выполняется. Посторонние соображения (увещевания, уговоры, призывы) неэффективны, поскольку работают в лучшем случае "на адреналин". На адреналине человек делает эффектный участок кода, и ставит затычки на то, что он знает плохо или что требует внимания, длительной отладки и продумывания взаимосвязей. К тому же любой человек может просто аккуратно вывести себя из целевой группы и встать в позицию наблюдателя, поддакивающего "да, никто не делает Форт, кошмар какой... да, всем наплевать". А почему? Да потому что считает для себя неприемлемым делать в свободное время то, что ему навязали. Я вижу перспективу не столько в "давайте напишем Форт вместе", сколько в "давайте посмотрим, какой именно Форт вообще получится написать вместе".


Вернуться к началу
 Профиль Отправить личное сообщение  
Ответить с цитатой  
 Заголовок сообщения: Re: соглашения по оформлению кода
СообщениеДобавлено: Пт июн 26, 2015 17:27 
Не в сети
Moderator
Moderator
Аватара пользователя

Зарегистрирован: Чт май 04, 2006 00:53
Сообщения: 4956
Откуда: был Крым, теперь Новосибирск
Благодарил (а): 18 раз.
Поблагодарили: 56 раз.
Hishnik писал(а):
Есть и другая сторона.

Другая сторона есть всегда, и правило: "за все надо платить" тоже не выключается никогда 8( увы.

Hishnik писал(а):
Зажав авторов необходимостью соблюдать непривычные соглашения

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

Hishnik писал(а):
Тем более если все компилируется...

должно еще и читаться нормально.

Hishnik писал(а):
На практике, такие голосования

вот и посмотрим на практике

Hishnik писал(а):
Конкретно у меня сейчас работают \ и //. Многострочных комментариев нет по другим соображениям

ведь речь не только о коментариях, а еще и о именовании определений, именовании параметров, и прочего. Коментарии вторичны, могу лишь предложить добавить следующие коментарии:
\? коментарий до конца строки
\! коментарий до конца строки
которые удобно использовать в работе и общении

Hishnik писал(а):
"Распланирован" <> "навязано ТЗ". Факт: навязанное ТЗ при свободном участии не выполняется.

ТЗ должно создаваться и согласовываться всеми участниками, тем более, что это более важная часть, чем код (на начальном этапе безусловно самая важная)

Hishnik писал(а):
Я вижу перспективу не столько в "давайте напишем Форт вместе", сколько в "давайте посмотрим, какой именно Форт вообще получится написать вместе".

т.е. просто по приколу?

_________________
Мне бы только мой крошечный вклад внести,
За короткую жизнь сплести
Хотя бы ниточку шёлка.
fleur


Вернуться к началу
 Профиль Отправить личное сообщение  
Ответить с цитатой  
Показать сообщения за:  Поле сортировки  
Начать новую тему Ответить на тему  [ Сообщений: 5 ] 

Часовой пояс: UTC + 3 часа [ Летнее время ]


Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 3


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

cron
Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group
phpBB сборка от FladeX // Русская поддержка phpBB