DiscourseSkill.md

Разработка
6

Согласен. Как я уже говорил, это была первая версия, и теперь она улучшена благодаря вашей обратной связи. Мы посмотрели ещё раз, и вы оказались правы.

Добавлено в метод ревью

  • Классификация кандидата до проверки файлов:

    • Плагин
    • Тема
    • Компонент темы
    • Гибридное расширение
    • Репозиторий интеграции
    • Артефакт релиза

  • Отдельный инвентарь общего репозитория/релиза:

    • README, лицензия, журнал изменений
    • Файлы пакетов и файлы блокировок
    • Воркфлоу CI
    • Скрипты установки/Docker
    • Интеграции с внешними сервисами
    • Сгенерированные ассеты релиза
    • Отмеченные/архивные релизы
    • Соответствующие неотслеживаемые и игнорируемые файлы

  • Расширенный инвентарь плагина:

    • Каждый файл, загружаемый, регистрируемый или экспонируемый plugin.rb
    • config/routes.rb
    • db/post_migrate/
    • Представления, движки, валидаторы и middleware
    • Код административного и публичного фронтенда
    • Коннекторы, компоненты, маршруты, сервисы, шаблоны и тесты фронтенда
    • Общие, десктопные, мобильные, административные и встроенные стили
    • Фикстуры, вспомогательные файлы и браузерные/системные тесты
    • Зависимости Ruby, JavaScript, системные и зависимости от внешних сервисов
    • .discourse-compatibility
    • Ветки и воркфлоу d-compat/*
    • Заданные границы версий Discourse

  • Новый инвентарь темы/компонента темы:

    • Корневой about.json
    • Классификация component
    • Метаданные лицензии, автора, версии и совместимости
    • Заданные ассеты, цветовые схемы, скриншоты и настраиваемые параметры темы
    • Корневой settings.yml
    • Корневой locales/
    • common/, desktop/ и mobile/
    • Файлы SCSS и поддерживаемые файлы инъекции HTML
    • Корневой javascripts/
    • api-initializers/
    • Все файлы .js, .gjs и .hbs
    • Корневой stylesheets/ и импортируемые таблицы стилей
    • Корневой assets/ и все ссылки на них
    • Предпросмотр/скриншоты
    • Тесты и конфигурация линтера/сборки
    • Метаданные совместимости и ветки
    • Упакованные/экспортированные байты темы

  • Новые структурные проверки:

    • Заданный тип расширения должен соответствовать about.json и поведению при установке.
    • component: true означает компонент темы.
    • component: false или отсутствие поля означает полноценную тему.
    • Гибридные репозитории получают все применимые инвентари.
    • Неправильно размещённые или неожиданные файлы исследуются, а не игнорируются молча.
    • Отсутствие необязательных каталогов не является автоматически дефектом.
    • Рабочее дерево, архив релиза, установленное расширение, сгенерированные ассеты и публичный кандидат — это отдельные поверхности доказательств.

  • Новый чек-лист для полноценной темы:

    • Идентичность метаданных
    • Рендеринг полной темы
    • Покрытие основных страниц
    • Настройки, локали и ассеты
    • Поддерживаемые инициализаторы JavaScript/API
    • Адаптивное поведение, доступность и RTL
    • Поведение Foundation, Horizon и встроенных элементов
    • Взаимодействия с компонентами темы
    • Проверки установки, обновления, отката и совместимости

Я надеюсь, что вклад сообщества поможет улучшить Skill, а сам Skill поможет другим оценивать свою работу или, откровенно говоря, работу других до установки, если есть сомнения в качестве.

Пока что у нас 2 из 2. Ваш вклад привёл к улучшениям Skill, и @satonotdead нашёл его полезным. Спасибо за добрые слова и поддержку, @satonotdead