Участь у проєкті

Зацікавлені у поліпшенні ghostwriter? Будь ласка, ознайомтеся із наведеними нижче розділами, щоб дізнатися про те, як ви можете взяти участь.

Звіти щодо вад

Виявили ваду? Будь ласка, повідомте про неї за допомогою системи стеження за вадами KDE. Виконайте наші настанови щодо звітування про вади! Найважливіше: не забудьте вказати номер версії ghostwriter, якою ви користуєтеся.

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

Пошук причин вад

Ви можете допомогти із пошуком причин звітів про вади у системі стеження за вадами — відтворіть ваду і отримайте додаткові відомості від авторів звітів, щоб визначити причину проблеми. Також будемо раді, якщо ви закриєте дублікати вад та якось інакше спростите обробку даних. Щоб дізнатися більше, будь ласка, ознайомтеся із настановами щодо пошуку причин вад.

Нові можливості і виправлення вад

Знаєтеся на програмуванні? Виконайте ці кроки:

Надішліть звіт щодо вашої можливості або вади у системі стеження за вадами KDE.
Зауваження: цей крок потрібен для забезпечення того, щоб нова можливість відповідала меті проєкту, або того, щоб звіт щодо вади не був насправді звітом щодо реалізації нової можливості. Вам також варто синхронізувати області коду, які ви оновлюватимете, з кодом основної гілки, щоб уникнути конфліктів об'єднання, якщо хтось іще одночасно працює із тим самим кодом.
Після обговорення у повідомленні щодо вади, створіть програмний код для реалізації можливості або виправлення вади. Будь ласка, виконуйте настанови щодо стилю програмування KDE Frameworks. Важливо: будь ласка, сконцентруйте ваші зміни у коді на виправленні вади. Не пов'язані із виправленням зміни у коді слід пов'язати із іншими вадами або запитами щодо об'єднання гілок, щоб спростити рецензування та тестування змін.
Надішліть запит щодо об'єднання коду щодо основної гілки (master) із вашим оновленням коду.
Важливо: будь ласка, створіть об'єднаний внесок у git, перш ніж надсилати запит щодо об'єднання!
Зачекайте на коротку рецензію на код і на принаймні двох інших добровільних помічників, які випробують вашу можливість або виправлення вади.
Оновлюйте ваш запит щодо удосконалення за отриманими відгуками.
Щойно ваш запит щодо удосконалення буде затверджено принаймні двома іншими добровільними тестувальниками, ваш код буде об'єднано із основною гілкою розробки.

Рецензування коду

Знаєтеся на програмуванні і уважні до деталей? Станьте добровільним рецензентом нових запитів щодо удосконалення програми!

Пошукайте новий запит щодо удосконалення і додайте коментар щодо того, що ви хочете рецензувати код у ньому.
Надайте коментарі щодо коду.
Очікуйте на оновлення запиту щодо удосконалення (якщо це потрібно).
Продовжуйте писати відгуки, аж доки не будете певні, що код є якісним.
Залиште коментар із вашим схваленням запиту щодо удосконалення.
Щойно два добровільних рецензенти надішлють схвалення, запит щодо удосконалення буде об'єднано із основною гілкою коду програми.

Ось декілька підказок щодо того, на що слід звернути увагу під час рецензування:

Чи відповідає поданий код настановам щодо стилю програмування для 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); // Оце тобі!

Тестування

Приєднуйтеся до рецензування коду і тестування нових можливостей і виправлень вад! Виконайте ці кроки:

Пошукайте новий запит щодо об'єднання і додайте коментар щодо того, що ви беретеся за його тестування.
Зберіть код із запитом щодо удосконалення на вашій платформі.
Перевірте, чи реалізовано можливість або чи виправлено ваду. Спробуйте знайти ваду у роботі!
Надайте відгук щодо результатів тестування на сторінці запиту щодо удосконалення.
Очікуйте на оновлення запиту щодо удосконалення (якщо це потрібно).
Продовжуйте тестування і пишіть відгуки, аж доки не будете певні, що код працює.
Залиште коментар із вашим схваленням запиту щодо удосконалення.
Щойно ще один добровільний тестувальник надішле схвалення, запит щодо удосконалення буде прийнято.

Переклади

Будь ласка, долучайтеся до команди з перекладу KDE, щоб перекладати ваші улюблені програми мовою, яку ви добре знаєте.

Технічна підтримка

Обізнані із Linux або збиранням для MacOS? Знаєте, як виправити проблему, з якою стикаються інші користувачі? Будемо дуже раді вашим відповідям на питання користувачів та виявленню причин вад за допомогою системи стеження за вадами KDE!