Показать сообщение отдельно
  #21  
Старый 14.10.2015, 00:19
Аватар для Bargest
Bargest Bargest вне форума
Профессионал
 
Регистрация: 19.10.2010
Адрес: Москва
Сообщения: 2,390
Версия Delphi: XE3/VS12/FASM
Репутация: 14665
По умолчанию

Цитата:
А вы еще показали бы уникальное применение своего генератора?
Да ладно, каждый обучался на таких "Incredible Machine", будь то самопальные калькуляторы, архиваторы, тетрисы, танчики, плееры или браузеры. Тут хоть нестандартно.

По документации:
1) Почему лицензия в "заключении"? Обычно с неё начинают, или же выводят отдельным пунктом.
2) Фактически, вся документация состоит из "введения" и (автогенерированных?) шаблонных описаний функций. Автодоки - это хорошо и полезно, но все же наличие описания самой системы все равно нужно иметь. Хотя бы информацию о том, как его запустить и сконфигурировать "с нуля". Представь, что сам первый раз в жизни видишь этот генератор. Вот ничего ты не знаешь про него. Не знаешь даже, какие буквы писать в делфи. И тебе надо на основе этого генератора что-то сделать. Варианты "интуитивно понятно" и "ну почитать описание существующих функций модулей" сразу отбросить, если хочется нормальную документацию. Конечно, многие проекты документированы либо никак, либо просто описанием функций, но наличие хотя бы текстового описания "надо инициализировать и и запустить генератор" полезно. Можно уже отталкиваться: "ага, инициализировать - значит ищем функцию инициализации; запустить - ищем в доках, как запускать".
3) Я чего-то не понял - во введении указаны только две функции, а в доках их о-го-го. Если программисту предполагается использовать только две, то почему они растворены в описании кучи внутренних функций, если их использование при подключении модуля не предполагается? А если предполагается, то вообще ничего не понятно.
__________________
jmp $ ; Happy End!
The Cake Is A Lie.
Ответить с цитированием