Как помочь

Хотите сделать ghostwriter ещё лучше? В разделах ниже рассказано, как можно внести свой вклад.

Отчёты об ошибках

Нашли ошибку? Сообщите о ней в системе отслеживания ошибок KDE. Не забудьте следовать правилам сообщения об ошибках! И самое главное — не забудьте указать номер используемой версии ghostwriter.

Внимание: если не указать сведения, требуемые в шаблоне отчёта об ошибке, отчёт об ошибке будет автоматически закрыт.

Разбор сообщений об ошибках

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

Новые возможности и исправления ошибок

Умеете программировать? Выполните следующие действия:

  1. Создайте отчёт о новой возможности или ошибке в системе отслеживания ошибок KDE.
    Примечание. Этот шаг необходим, чтобы убедиться, что новая возможность соответствует целям проекта или что ошибка на самом деле не является возможностью. Кроме того, следует согласовать, какие участки кода будут изменяться, чтобы избежать конфликтов слияния, если над тем же участком кода работает кто-то ещё.
  2. После обсуждения новой задачи реализуйте новую возможность или исправьте ошибку. Придерживайтесь руководства по оформлению кода KDE Frameworks. Важно: код должен относиться только к рассматриваемой задаче. Посторонние изменения в коде следует оформлять отдельными задачами или запросами на слияние — так проще проверять код и тестировать.
  3. Отправьте запрос на слияние в ветку master с изменениями кода.
    Важно: перед отправкой запроса на слияние объедините фиксации в git!
  4. Дождитесь краткой проверки кода и тестирования новой возможности или исправления ошибки как минимум двумя другими добровольцами.
  5. Обновляйте запрос на слияние по мере получения отзывов.
  6. После того как запрос на слияние одобрят по крайней мере ещё два добровольца-тестировщика, его примут.

Проверка кода

Умеете программировать и замечаете детали? Примите участие в рецензировании новых запросов на слияние!

  1. Найдите новый запрос на слияние и добавьте комментарий о том, что хотите проверить код.
  2. Отправьте комментарии к коду.
  3. Дождитесь обновлений запроса на слияние (при необходимости).
  4. Продолжайте оставлять отзывы, пока не убедитесь, что код корректен.
  5. Оставьте комментарий с одобрением запроса на слияние.
  6. Как только как минимум два добровольца-тестировщика дадут своё одобрение, запрос на слияние будет принят.

Несколько советов о том, на что обращать внимание при проверке кода:

  • Соответствует ли отправленный код руководству по оформлению кода KDE Frameworks?
  • Легко ли читается код, есть ли комментарии, поясняющие неочевидные строки?
  • Является ли код «пессимистичным»? Иными словами, проверяет ли он недопустимые значения перед их использованием и обрабатывает ли возможные ошибки?
  • Заключены ли множественные сравнения или инструкции в скобки внутри if, чтобы избежать случайных ошибок из-за порядка выполнения операций? Примеры:
    // Неверно
if (a == b || c > d);

// Верно
if ((a == b) || (c > d));
  • Ставятся ли литералы слева от оператора ==, чтобы опечатка с оператором = не ускользнула от внимания компилятора? Примеры:
    // Неверно
if (variable == 1);

//         Причина: а если в коде опечатка? Компилятор её не обнаружит!
if (variable = 1); // Ой!
// Верно
if (1 == variable);

//         Причина: на этот раз компилятор обнаружит опечатку.
if (1 = variable); // Ой!

Тестирование

Примите участие в проверке кода и тестировании новых возможностей и исправлений ошибок! Выполните следующие действия:

  1. Найдите новый запрос на слияние и добавьте комментарий о том, что хотите его протестировать.
  2. Соберите запрос на слияние на своей платформе.
  3. Проверьте новую возможность или исправление ошибки и попробуйте их сломать!
  4. Оставьте отзыв о результатах тестирования в запросе на слияние.
  5. Дождитесь обновлений запроса на слияние (при необходимости).
  6. Продолжайте тестировать и оставлять отзывы, пока не убедитесь, что код работает.
  7. Оставьте комментарий с одобрением запроса на слияние.
  8. Как только как минимум ещё один доброволец-тестировщик даст своё одобрение, запрос на слияние будет принят.

Переводы

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

Техническая поддержка

Разбираетесь в Linux или в сборке для MacOS? Знаете, как исправить ту самую проблему, с которой постоянно сталкиваются другие? Ваши ответы на вопросы пользователей и помощь в решении проблем в системе отслеживания ошибок KDE будут очень ценны!