Привет, я представляю студию «Диван.Дизайн». Вот уже больше пяти лет мы разрабатываем сайты на MODx Evo. Так уж сложилось, что проблемы мы всегда старались решать в общем виде и у нас скопилось множество различных готовых программных продуктов (всяких там сниппетов, плагинов, модулей, ну вы знаете). Практически всё это время мы хранили все эти штуки локально и никуда не выкладывали (по разным причинам, опустим их ;-). Потом мы как-то раз доработали и выложили парочку продуктов из официальной сборки (ManagerManager, например), и нам понравилось. Не понравился нам лишь официальный репозиторий MODx, какой-то он «не очень»… Мы сели, подумали и выявили несколько моментов, которые хотелось бы видеть в репозитории:
- Навигация по продуктам при помощи тегов (пожалуй, самое удобное что можно придумать).
- Вывод всех продуктов с разной сортировкой: по дате обновления, имени и количеству загрузок.
- Отображение названия продукта, даты, краткого описания и количества загрузок в списке всех продуктов.
- Каждый продукт должен быть разбит на версии, у каждой версии должны быть:
- Тип (плагин, модуль, сниппет, etc), название, версия, дата, теги.
- Список всяких библиотек и других продуктов, которые используются, по возможности со ссылками и комментариями, надо ли подключать дополнительно, или всё уже содержится в архиве.
- Описание, простое человеческое словесное описание.
- Скриншоты (если есть чего показать).
- Документация: инструкции по установке, настройке, описание параметров. У каждого параметра должны быть: название, описание, возможные значения, значение по умолчанию и обязателен ли он.
- Примеры использования.
- Многоуровневые древообразные комментарии. Это очень важно, у людей должна быть возможность здесь же задать вопрос, ответить на вопросы других, сообщить о баге, предложить решение, да и просто посмотреть, что уже обсуждалось.
- Список изменений (changelog) по сравнению с предыдущей версией.
- Также нужна отдельная страница с полным списком изменений по всем версиям. Это просто необходимо, когда надо обновить что-то с версии, скажем, 0.x до 1.x (очень удобно сразу видеть, где по пути что менялось и какие могут возникнуть проблемы).
- Простой, не напрягающий, красивый, минималистичный дизайн, никаких лишних красивостей, но и не без необходимых, чтобы было удобно повседневно пользоваться.
- Возможность связаться с разработчиками (форма обратной связи, например).
- Мультиязычность. Не все хорошо знают английский, да и на родном просто удобней порой читать.
- RSS со всеми продуктами и версиями.
В итоге мы просто взяли и сделали свой репозиторий, стараясь учесть и реализовать все вышеописанные моменты, и наполнили его своими продуктами. Пока выложили ещё далеко не всё, но самое вкусное, на наш взгляд. Ах да, code.divandesign.ru =)
Писать здесь про все продукты не буду, очень много, да и в репозитории описания все есть. Особо хочется отметить новую версию ManagerManager (теперь 0.4, пора приближаться к 1.0 ;-), приуроченную к открытию самого репозитория и модуль ddMMEditor к нему.
Что ж, пользуйтесь на здоровье, пишите предложения, идеи, вопросы в каменты и всё такое. Также читайте наш твиттер, мы туда иногда пишем и всегда отвечаем)
Всем хорошего дня, добра и позитива!
ссылка на оригинал статьи http://habrahabr.ru/post/163159/
Добавить комментарий