Документация!
Создайте пожалуйста человеческую документацию по работе с cms. Если с ней будут работать только профи - будущего у неё не будет.
Комментарии
-
А воз и ныне там!
Прошло уже больше полгода, а нормальных доков нет. Очень жаль.
-
Спасибо за Ваши пожелания, мы постараемся подготовить пошаговое руководство по созданию простого сайта.
Также просим, по возможности, предоставить конкретные предложения по примерам, которых не хватает.> Также просим, по возможности, предоставить конкретные предложения по примерам, которых не хватает.
1. Необходим список хуков с описаниями.
2. Вообще всё что связано с модулями, хуками и расширением системы.
В ответ на http://hostcms.ru/support/wishlist/9E367420-A479-3652-0315-1A3C8FFBF3FD/#comment3390
Нормальная документация - когда она с примерами использования и объяснением зачем надо делать так.
Самый удачный пример документации это CI. Мого примеров, мало слов.Наконец-то Всевышний услышал! Благодарю! Это очень большая работа написать хорошую инструкцию. Бог Вам в помощь! С уважением, Евгений.
-
Народ, хватит минусовать. Я сам так же писал на форумах и в техподдержку, в самом начале знакомства с HostCMS.
Это как дом построить, а лестницу к входной двери не проложить, пусть каждый приходящий сам лестницу ваяет, хоть от двери к асфальту, хоть наоборот.Благодарю за поддержку. Какое-то время я думал, что минусы ставят разработчики hostcms, но все взвесив, я понял, что минусуют как раз те самые "профи". Почему?
Да потому-что, если вдруг появится нормальная документация, их монополия кончится, и этой замечательной cms смогут пользоваться десятки тысяч других профессионалов, у которых сейчас просто нет времени сидеть и разбираться в этом продукте.
Вот только посмотрите, что делает UMI: они создают вэбинары для обучения опытных и только начинающих:
Приглашаем на обучающий курс, который будет полезен как опытным, так и начинающим разработчикам на UMI.CMS, желающим начать создавать сайты с помощью профессиональных инструментов. Вебинар пройдет 12 ноября 2013 с 10:00 до 13:00, предварительная регистрация обязательна. Не пропустите!
Курс будет полезен веб-разработчикам, уже имеющим опыт работы с UMI.CMS и понимающим принцип работы XSLT-шаблонизатора, а также основы API. Цель обучения — получить представление о создании новых кастомных макросов (методов) или расширение функционала существующих, а также кастомизации административного интерфейса. Вебинар пройдет 12 ноября 2013 с 14:00 до 17:00, предварительная регистрация обязательна. Обязательно посетите это вебинар!
И другие... Я не рекламирую UMI, т.к. данные вэбинары уже прошли, а только показываю как люди работают. Может всетаки HOSTCMS сделают нормальную человеческую документацию! С уважением, Евгений.
-
На самом деле система очень простая и мне кажется, что вполне нормальная реакция, мы вежливо запросили конкретнее, что именно Вам не хватает в документации. Ваши сравнения замечательные, но не содержат никакой конкретной информации.
Конкретней... Пример подачи информации.
Работа с шаблонами (пример) - http://www.instantcms.ru/wiki/doku.php/%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA:%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B0_%D1%88%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D0%B0
Структура базы данных (пример) - http://www.instantcms.ru/wiki/doku.php/%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA:%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B0_%D0%B1%D0%B0%D0%B7%D1%8B_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85
Управление и передача значений (пример) - http://www.instantcms.ru/wiki/doku.php/%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA:%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B8_%D0%BF%D0%B5%D1%80%D0%B5%D0%B4%D0%B0%D1%87%D0%B0_%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B9И вот еще пример документации - http://djbook.ru/rel1.5/
Да, возможно она очень простая, но для вас. Т.к. вы собаку съели и знаете все ходы и выходы. Так вы подготовьте инструкцию, прочитав которую любой специалист в области сайтостроения тоже сможет разобраться в ней за короткое время и сказать, что она простая. Я знаю, что написать грамотный manual сможет не каждый даже очень хорошо разбирающийся специалист, что это большая и очень трудоемкая работа. Но она стоит того. С уважением, Евгений.
-
Поясните, пожалуйста, что в Вашем понимании человеческая документация?
Разрабатывать сайты будут профи, потому что для этого необходимо владение технологиями. Управлять могут обычные пользователи, у нас отличная документация пользователя.Документация вполне может быть и отличной, красивой и прочее. Но новым хостцмсовцам, которые еще не вникли в идеологию и архитектуру системы так не покажется. Скажем совсем новый поклонник вполне возможно в первые часы может получить поддых от ситуация с магическими кавычками. Разумеется возражения сразу же возникают, но обратите внимание 1) этого в документации нет, 2) можно сказать что это дилетант, да, но это пользователь, и фраза отличная документация пользователя, сразу становится как-то ложной.
Хочу сказать есть над чем работать.
Очень жаль, что вы так отреагировали. Ну да, ладно. Пример: вы разбираете принтер, чтоб заменить памперс и не можете снять кожух, потому что изнутри стоят защелки, которых снаружи невидно. А в документации написано: снимите кожух, отверните винт, который держит памперс и замените памперс. А как снять корпус и где находятся защелки об этом ни слова. Поэтому приходится писать письмо в техподдержку, выяснять, как же все таки снять корпус и где находятся защелки или тупо ломать эти защелки, чтобы снять корпус. Хотя в инструкции достаточно было поместить картинку с защелками и ни каких больше вопросов. Это на счет человеческой документации. Одним из примеров нормальной документации есть документация фирмы 1с или сервисная инструкция машины Toyota, где прописано все вплоть до самой маленькой шайбочки. Так вот таких подводных камней, как эти защелки на корпусе в вашей cms много. Сама система довольно не интуитивная, чтоб понять все методом тыка. Информация об разных нюансах раскидана в разных местах: на форуме, в прилагаемых инструкциях, в типовых шаблонах и т.д. Я понимаю, что для разработки сайта необходимо знать: html, css, pxp, xml... Но у каждого профи свой уровень. И не все профи знают вашу cms на 100%. Поэтому и нужна подробная, структуированная документация, по которой можно было изучить и понять как и что надо делать, а не тратить кучу времени, ища крупицы информации на форуме. С уважением, Евгений.
