Spec-Zone.ru › Wagtail 3

Содействие развитию Wagtail

Проблемы

Самый простой способ внести свой вклад в Wagtail — это рассказать нам, как его улучшить! Сначала проверьте, не было ли уже подано ваше сообщение об ошибке или запросе новой функции на github.com/wagtail/wagtail/issues. Если да, и у вас есть дополнительная информация, которая может помочь нам с ней разобраться, оставьте комментарий к существующей проблеме. Если нет, пожалуйста, создайте новую, предоставив как можно больше контекстной информации. Например, если у вас возникли проблемы с установкой, укажите свою среду и шаги, которые вы уже предприняли. Если что-то отображается некорректно, укажите, какой браузер вы используете, и, если возможно, прикрепите скриншот.

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

  • Отслеживание проблем
    • Проблемы
    • Запросы на включение изменений
    • График выпуска

Запросы на включение изменений

Если вы разработчик Python или Django, сделайте форк и прочтите документацию по разработке, чтобы начать работу! Мы приветствуем все contributions, решающие как специфические для вас проблемы, так и существующие задачи. Если у вас нет идей, выберите что-нибудь из списка задач или напишите нам напрямую на hello@wagtail.org, если вы хотите, чтобы мы предложили что-то.

Для крупных изменений мы обычно рекомендуем разбивать их на более мелкие запросы на включение изменений, которые решают одну определенную задачу и могут быть рассмотрены по отдельности. Если это невозможно, мы рекомендуем открыть запрос на включение изменений в репозитории Wagtail RFCs, чтобы у сообщества была возможность обсудить изменение до его реализации.

  • Разработка
    • Настройка кодовой базы Wagtail
    • Тестирование
    • Компиляция статических ресурсов
    • Использование библиотеки шаблонов
    • Компиляция документации
    • Автоматическое форматирование и проверка кода при коммитах
  • Создание коммитов
    • Выгрузка кода локально
    • Перебазирование на main
    • Обновление CHANGELOG.txt и примечаний к релизу
    • Отправка на main
    • Когда вы допустили ошибку
    • Добавление коммитов в pull-реквест другого человека

Переводы

Wagtail поддерживает интернационализацию, поэтому, если вы свободно владеете языком, отличным от английского, вы можете внести свой вклад, локализуя интерфейс.

Работа по переводу должна быть представлена через Transifex.

Другие contributions

Мы приветствуем contributions ко всем аспектам Wagtail. Если вы хотите улучшить дизайн пользовательского интерфейса или расширить документацию, отправьте запрос на включение изменений, как описано выше. Если вы не знакомы с Github или запросами на включение изменений, свяжитесь с нами напрямую, и мы найдём решение.

Разработка пакетов для Wagtail

Если вы разрабатываете пакеты для Wagtail, вы можете добавить следующие классификаторы PyPI:

  • Framework :: Wagtail
  • Framework :: Wagtail :: 1
  • Framework :: Wagtail :: 2
  • Framework :: Wagtail :: 3

Вы также можете найти отобранный список отличных пакетов, статей и других интересных ресурсов от сообщества Wagtail в Awesome Wagtail.

Дополнительная информация

  • Руководство по стилю пользовательского интерфейса
  • Общие рекомендации по написанию кода
    • Язык
  • Рекомендации по написанию Python-кода
    • PEP8
    • Совместимость с Django
    • Тесты
  • Рекомендации по написанию HTML-кода
    • Проверка HTML-кода
    • Принципы
  • Рекомендации по написанию CSS-кода
    • Проверка и форматирование SCSS
    • Справочник по стилю
  • Рекомендации по написанию JavaScript-кода
    • Проверка и форматирование кода
  • Рекомендации по составлению документации
    • Рекомендации по форматированию
    • Форматирование, которому следует избегать
  • Написание документации
    • Выбор режима написания
    • Учебник
    • Руководство по использованию
    • Ссылка
    • Объяснение
  • Сообщения о проблемах безопасности
    • Поддерживаемые версии
    • Как Wagtail сообщает о проблемах безопасности
    • Соображения по безопасности экспорта CSV
  • Процесс выпуска Wagtail
    • Официальные выпуски
    • График выпуска
    • Политика устаревания
    • Поддерживаемые версии
    • Поддерживаемые версии Django
    • Процесс выпуска

© 2014-present Torchbox Ltd and individual contributors.
All rights are reserved.
Licensed under the BSD License.
https://docs.wagtail.org/en/v3.0.3/contributing/index.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API