Привет всем.
Занимаюсь разработкой системы под названием PHP Compiler (или просто PHPC).
Что-то типа несложного движка для разработки сайтов "с нуля", фреймворк в общем.
Система бесплатная, опенсоурс. Нужны отзывы: мнения, замечания, пожелания, предложения и т. д.
Скачать последнюю версию можно здесь.
Зачатки документации здесь. Там же написано, что это такое, как устанавливать и пользоваться. По части документации мнения даже еще важнее...

Отзыв по документации.
Увидел колво страниц - закрыл

Хех
Говоря откровенно, для того, чтобы понять движок, достаточно пункта 1.1 (ссылка), остальное можно не читать ;)
Один пункт при желании можно "асилить", страниц там... гм, всего две...
Но спасибо за отзыв, я уж думал здесь совсем глухо.

Не понятно, какую цель преследует проект. Если это -- движок для не программистов (дизайнеров, новичков), то где доступная документация (просто, доходчиво, подробно)? Объяснения типа:

просто будут непонятны. Тогда было бы лучше сделать два типа документации:
1. Руководство для администратора сайта (на уровне блондинки)
2. Руководство разработчика (программиста, который на основе движка создает сайт)

Может быть, стоило использовать Smarty? Не потому, что это лучше -- просто многие с этим шаблонизатором знакомы. И он хорошо документирован.

Посмотрим на вопрос с другой стороны. Если бы я выбирал движок для создания сайта, никогда бы не выбрал PHPC. Я просмотрел около 10 файлов PHP -- НИ ОДНОЙ СТРОЧКИ КОММЕНТАРИЯ. Наверняка придется адаптировать движок к нуждам конкретного сайта, а разбираться в таком коде -- удовольствие ниже среднего. Ты относишься к тем программистам, которые считают: "то, что тяжело писалось, должно тяжело читаться". Отсюда можно сделать вывод -- писалось не для программистов.

Тогда для кого?

Есть правда еще один вариант -- для практики. Как еще можно научиться писать (в смысле программировать)? Писать, писать, писать! И это правильно! Тогда все становится на свои места.

Но что ты хочешь услышать в качестве комментариев? 9 из 10 поленятся читать чужой код. И уж тем более -- код без комментариев...

evgenijj
Во-первых, спасибо! Настоящий отзыв, то что нужно
Далее по тексту:

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

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

Насчет комментариев верно, но адаптировать движок под свои нужды не нужно. Еще раз - это CMF, не CMS, надеюсь, ты понимаешь разницу. CMS адаптируют - а CMF расширяют, изучая при этом систему, но изучая не по комментариям в исходном коде, а по документации.

Отвечаю - писалось в первую очередь для себя, а следовательно - для программистов. Насколько "войти" в систему легко - уже зависит от ее качества, главным образом от качества архитектуры и мануала. Разумеется, это хобби, но я верю в то, что вещи, созданные "для себя", лучше и удобнее вещей, созданных "для других". Созданные мной сайты на PHPC (особенно сравнительно с созданными мной же сайтами на связке PEAR+Smarty) это подтверждают. Разумеется, это всего лишь личное мнение разработчика. ;)

Ну насчет кода я полностью согласен с evgenijj, удовольствия получил мало...

Описание читать лень, одно описание установки чего стоит. Да и сам процес очень неудобен, например мне чтобы установить твой движок надо снести все разработки которые лежат на локольном хосте, хоть даже на время. Это сильно будет мешать, не у всех людей пустой хост !

Далее, логотип :
Вот как ни странно но он мне чего-то напоминает... а вам ? Нечто подобное я видел там http://php.net поэтому лично мое мнение, во избежании неприятностей - стоит его убрать.


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

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

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

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

Начал с первого раздела:
1.1. Введение, или Что такое PHPC?

Понял я так, это бесплатная [уже хорошо], система для разработки веб сайтов.


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



Не знаю я что это такое.
Что за слов туда напихал?


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


Если ты не дизайнер то и тут в принципе до лампочки как там всё внутри построено, главное чтоб работало.
Тут я подумал что стоит разделить это дело на три раздела, для программистов, дизайнеров верстальщиков, и блондинок.


Те же комментарии. Кто такие эти умные Смарти, чёрт побери?

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

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

Быстрая и лёгкая установка
Высокая скорость работы
Достойный уровень безопастности вашего сайта
Возможность смены дизайна не влезая в программный код.
Поддержка готовых макетов / стилей [ подчеркни нужное =) ]
Периодически обновляется и расширяется
Поддержка мульти-языковых сайтов
Простая удобная и понятная Панель администрирования.

Здорово, а в чём собственно сами преимущества в таком подходе?
Это мне лично..
А для не программистов такой текст не пройдёт.

Я пришёл к выводу что программа phpc разработана только для программистов
А те кто сами могут написать то что надо, могут файлы и в базу и на сервер да и куда только влезет =)
Да и в чужом коде разбираться не придётся.


Знаешь, мне понравилось построение первого раздела.
Вступление. Приличный для вступления - размер.
Дальше идёт "Подробнее", который короче самого вступления раза в три.
Кстати, после того как я его прочитал я просто подумал ты заголовки эти просто поставил не правильно, и тот коротенький текстик на самом деле вступление.
Поменяй их на самом деле местами. Довольно таки неплохо выйдет.

Хорошо хоть во втором пункте самой подробности объясняется что такое шаблон. =)
А то в первой словом "шаблон" частенько оперировали.

То что есть пример сайта построенный при помощи системы - уже хорошо.
Но это должно быть в верху страницы "Посмотреть демо версию" или что то такое.

Посмотрел я демку админ панели, опять же тут же нажал на крестик.
Слишком много пунктов в меню с лева.
Вообщем надо если не сократить их количество то хотябы переделать интерфейс.
Страшно становится =)

Пункт 3, уже явно обращается только к программистам
но так будто программисты не умнее блондинок.


Остальное сил комментировать сегодня не хватит.




--
Всё выше сказанное несказанно в обиду блондинкам
и слово "блондинка" подразумевает под собою
стереотип о низко образованном человеке.
Заранее приношу свои извинения читателям женского пола.

-SCHATTEN-
Неужели ты серьезно? Я первый раз вижу человека, для которого отсутствие чистого хоста, пусть даже локального - проблема. С этой точки зрения и требование отдельной чистой БД для системы - тоже серьезное препятствие. Но это же несерьезно если ты сам ставил локально Апач - создание еще одного хоста не должно для тебя представлять сложности. Если ставил какой-нибудь Денвер - там все вообще элементарно. То же самое с базой мускула.

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

Описание установки - эта статья? Да это же подробное описание работы со встроенным инсталлятором - в любой уважающей себя системе есть такой. Вся установка сводится к 2 операциям: 1) следуем инструкциям инсталлятора; 2) заходим в админку и кликаем по 2 (двум) ссылкам в меню. Или я чего-то не понял? В таком случае опиши подробнее, что тебя так отпугнуло.



(Добавление)
valenok
Хм, это уже интереснее, со многим согласен, честно говоря...
возможно, что-то придется переписать, спасибо за мнение

Вот это уже не порадовало - подход тот же, что и в первом твоем сообщении здесь ;) хотя и тут есть зерно истины, для новичков админка может выглядеть чересчур усложненной. Хорошо, подумаю и над этим тоже.

Это не такая и проблема. (Назабывай что написано у меня в статусе над звездочками ;) )
Поэтому мне это и непонравилось. Ты просил чказать мнение, я его сказал...

Нет про то что он там должен быть я не спорю, я даже очень за !

Я бы тоже предпочёл бы чистый хост.
А вдруг твоя система чтото там испортит?

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

Я бы сделал следующим образом:
Делаешь в меню с лева шесть семь разделов, главных, тоесть без подразделов (настройки, сообщения, страницы сайтов).
И чтоб после нажатия на ссылку в основном фрейме открывался раздел предлагающий выбрать там под разделы (Редактирование настроек |Создать | Группа | Обзор) С коротким описание каждого раздела и того что там можно будет поделать.


(Добавление)
И про всякие там инсталляторы.
До меня пока дошло что надо им вообще попользоваться...
Надо тебе сделать файлик index.php
с оглавленем get started
где будет перечислены коротка мои следующие действия

Это главная страница phpc, она поможет вам сделать так, чтоб phpc работал у вас и на вас.
Всё что вам следует сделать так это нажать на следущую ссылку и следовать инструкциям.

valenok


Что еще раз доказывает, что дизайнер из меня никудышный ;) OK, принимаю на заметку. Наверное ты прав, на светлом фоне админка смотрелась бы более "приветливо".

Мысль хорошая, но вспомогательное меню (назовем это так) всяко не должно находиться в основном фрейме, т.к. после первого же выбора любого пункта это меню будет затерто. Нужно либо для него предусматривать еще один фрейм (=лишнее загромождение экрана, имхо), либо делать что-то типа разворачивающихся меню слева. Беда в том, что у обоих решений есть серьезный недостаток - нельзя будет попасть куда тебе нужно одним кликом. Другими словами, разобраться и освоиться в такой админке будет проще, а пользоваться ей - неудобнее.

Ну тогда там хоть выпадающее меню.
Чтоб вся информация за раз не сваливалась.
Всё сразу не усваивается да ещё и выглядит не очень.

С выпадающим меню это одним кликом да ещё двумя наведениями мышки.

У меня валялось прекрасное меню на JS "а-ля" дерево Explorera. Подсадить его на РНР будет довольно просто. Так что могу его скинуть если есть желание.

Скидывай поглядим.

Особенно мне нравится часть названия "Compiler". Как правило такие названия подразумевают возможность обратной компиляции. Аля PHP Decompiler. Или дизассемблер. А ещё точки останова скрипта. А посмотреть что у нас в каждой переменной... а в каждом бите. А ещё без комментариев. Я вот если ночь посижу, то потом на утро едва могу разобрать что написал, когда нет комментов.