https://alexbirukov.ru/?go=tags/hostcms/ Здесь я пишу свои идеи, мысли, описываю события своей жизни и просто делаю личные и рабочие заметки. «А Вы что, собираетесь жить вечно?» ru Aegea 11.3 (v4134) Здесь я пишу свои идеи, мысли, описываю события своей жизни и просто делаю личные и рабочие заметки. «А Вы что, собираетесь жить вечно?» 119 https://alexbirukov.ru/?go=all/dokumentirovanie-p-o/ Sun, 29 Jan 2012 23:35:46 +0500 https://alexbirukov.ru/?go=all/dokumentirovanie-p-o/ <p>Довольно часто при написании дипломов по программному обеспечению, я сталкиваюсь с рутинным занятием — написанием документации.<br /> Как правило, документация довольно детально и подробно должна описывать функции, меню, выполняемые операции и алгоритмы работы. А особо узкие места, сложные для понимания должны описываться более детально.<br /> Но вот недавно пришлось мне поработать с одной системой управления сайтом HOST CMS, сказать честно, ребята которые пишут документацию и ставят описание к элементам, ушлёпки. Как правило описание элемента в точности соответствует его названию. И всё бы ничего, я бы не был так возмущён, если бы это не был коммерческий продукт. Мои работы и те получается документированы лучше.<br /> Ребята, ёб вашу мать, пы продаёте это ГАВНО! Будьте любезны, доводиде дело до конца. Зачастую бесплатные проекты, которые пишутся одним человеком, выполнены значительно лучше.<br /> Чтобы не быть пустозвоном, вот несколько скринов:</p> <div class="e2-text-picture"> <div class="fotorama" data-width="174" data-ratio="2.6769230769231"> <img src="https://alexbirukov.ru/pictures/link.png" width="174" height="65" alt="Ссылка, да не может быть! Невероятно!" /> <img src="https://alexbirukov.ru/pictures/sort.png" width="180" height="67" alt="Ёба мать, а то я сам не понял" /> <img src="https://alexbirukov.ru/pictures/picture_1.png" width="255" height="71" alt="Капитан очевидность нервно курит в сторонке" /> </div> </div> <p>Если вдруг у вас возникла мысль, что можно скачать документацию, то спешу вас обрадовать, там описание не многим лучше. Особенно это касается документации программиста. Очень забавно выяснять, что за поле такое «Функция» и что туда вписывать, а главное, где эту функцию описать.</p> <p>P.S. В моём представлении, система CMS для того и создаётся, чтобы максимально упростить управление сайтом. Т. е. сделана для людей с минимальными знаниями программирования, а на деле выходит, что купив коммерческий продукт, мы должны быть и программистами, и менеджерами, и дизайнерам и если надо сантехниками, мать их. Учитесь писать нормальную документацию, блеать!</p>