How do I create a bug report/ru: what changed
Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.
Title: How do I create a bug report/ru
| Old | New | Line | |
|---|---|---|---|
| 1 | + | Этот документ содержит некоторые рекомендации по использованию [багтрекера](https://gitlab.com/freepascal.org/) FPC/Lazarus в качестве репортера. Этот документ написан для пользователей FPC / Lazarus, которые выявляют ошибки, имеют рекомендации, хотят отправить исправления или найти другие проблемы и хотят сообщить о них команде разработчиков Lazarus. | |
| 2 | + | ||
| 3 | + | ## Ошибки компиляции кода | |
| 4 | + | ||
| 5 | + | Если у вас есть ошибки при компиляции кода из последней версии SVN, пожалуйста, свяжитесь с соответствующим [списком рассылки FPC](http://freepascal.org/maillist.var) или [списком рассылки Lazarus](http://lists.lazarus-ide.org/listinfo), или лучше присоединитесь к IRC-каналу <b>\#fpc</b> или <b>\#lazarus-ide</b> на irc.freenode.net. Тогда проблема должна решаться более оперативно. | |
| 6 | + | ||
| 7 | + | ## Вход в систему / Создание новой учетной записи | |
| 8 | + | ||
| 9 | + | Вы должны войти в систему, чтобы иметь возможность редактировать или отправлять сообщения об ошибках. Если вы вошли в систему как гость, вам необходимо сначала выйти из системы (гости не могут создавать отчеты, только просматривать их). Если у вас уже есть учетная запись, перейдите на [страницу входа](https://gitlab.com/users/sign_in), в противном случае создайте новую учетную запись на [странице регистрации](https://gitlab.com/users/sign_up). | |
| 10 | + | ||
| 11 | + | ## Проверка на наличие существующей ошибки в трекере | |
| 12 | + | ||
| 13 | + | Используйте строку поиска в [Обзоре проблем](https://gitlab.com/groups/freepascal.org/-/issues). Подсказка: поиск не является интеллектуальным; например, если у вас возникли проблемы с использованием TEdit.SelStart, выполните поиск по запросу «SelStart». | |
| 14 | + | ||
| 15 | + | Если проблема уже была опубликована: | |
| 16 | + | ||
| 17 | + | - переоткройте ее, если отчет об ошибке был решен или закрыт - используйте кнопку Reopen Issue (переоткрыть вопрос) | |
| 18 | + | - добавьте примечание, если вы снова воспроизвели эту ошибку в ситуации, отличной от указанной | |
| 19 | + | - Вы можете настроить систему для отслеживания изменений в этом отчете об ошибках - используйте кнопку Monitor Issue (отслеживание проблемы) | |
| 20 | + | ||
| 21 | + | > **Note:** Вам необходимо войти в систему для выполнения этих операций, см. раздел [[How do I create a bug report/ru|Вход в систему / Создание новой учетной записи]] | |
| 22 | + | ||
| 23 | + | ## Что следует публиковать в багтрекере? | |
| 24 | + | ||
| 25 | + | - Баги: если вы обнаружили ошибки, глюки или другие дефекты в [[FPC]] или [[Lazarus]] | |
| 26 | + | - Предложения: если вы нашли лучший способ сделать что-либо | |
| 27 | + | - Улучшения: если вы можете заставить что-то работать лучше | |
| 28 | + | ||
| 29 | + | Пожалуйста, обратите внимание: багтрекер **не** предназначен для "бытовых" вопросов. Они должны задаваться на [форуме](http://forum.lazarus.freepascal.org/). | |
| 30 | + | ||
| 31 | + | - Для создания отчета перейдите в [багтрекер Lazarus](https://gitlab.com/groups/freepascal.org/lazarus/-/issues). Вы должны быть залогированы в системе, см. раздел [[How do I create a bug report/ru|Создание новой учетной записи]]. | |
| 32 | + | - Перейдите на страницу [Report Issue](https://gitlab.com/groups/freepascal.org/-/issues) (Сообщить о проблеме). Заполните столько, сколько вы можете и знаете. Чем конкретнее, тем лучше. | |
| 33 | + | ||
| 34 | + | ### Баг | |
| 35 | + | ||
| 36 | + | - Важными полями являются поля ОС и программного Продукта, а также действия по воспроизведению этой проблемы. Если разработчики не смогут воспроизвести проблему, они не смогут и начать ее исправлять! Не забудьте упомянуть вашу конкретную архитектуру/конфигурацию (32- или 64-бит, с прямым(BOM-BE) или младшим(BOM-LE) порядком байтов, если оба возможны на вашей платформе, версия вашей операционной системы). | |
| 37 | + | - Если возможно, <b>загрузите небольшое тестовое приложение, которое воспроизводит баг</b>. Это, скорее всего, ускорит исправление. | |
| 38 | + | - Если есть какая-то графическая ошибка, полезно загрузить (частично) скриншот (в формате png или jpeg, но не в формате bmp). | |
| 39 | + | - Если это падение среды, попробуйте создать обратную трассировку. См. [[Creating a Backtrace with GDB/ru|создание файла обратной трассировки с помощью GDB]] для получения дополнительной информации. | |
| 40 | + | - Вы можете попытаться воспроизвести ошибку на как можно большем количестве различных платформ - это поможет определить, является ли это специфической проблемой виджета. | |
| 41 | + | - Если у вас есть возможное решение, вы можете добавить патч - см. [[Creating A Patch/ru]], который ускорит процесс. | |
| 42 | + | - Вы можете ускорить исправление ошибки, назначив вознаграждение, см. [[Bounties|Поощрения]]. | |
| 43 | + | ||
| 44 | + | ### Регрессия, вызванная определенной ревизией | |
| 45 | + | ||
| 46 | + | Если вы можете найти ревизию в транке, которая вызвала ошибку, пожалуйста, включите также в сообщение ее номер ревизии SVN. Отчет обычно присваивается автору этой редакции. Вы можете найти нужную ревизию с помощью "bisect"-процесса, который представляет собой двоичный поиск по ревизиям. Есть инструменты, которые помогут с этим: | |
| 47 | + | ||
| 48 | + | - Команда Git [git bisect](https://git-scm.com/docs/git-bisect). Git быстр в этой операции, потому что вся история ревизий является локальной, и ничего не нужно извлекать с сервера. | |
| 49 | + | - Perl-скрипт [svn-bisect](http://search.cpan.org/dist/App-SVN-Bisect/bin/svn-bisect), доступный в CPAN. Он имитирует команду "git bisect", но работает непосредственно с данными SVN. | |
| 50 | + | ||
| 51 | + | ### Предложение | |
| 52 | + | ||
| 53 | + | Объясните свою идею. Может быть полезен макет графического интерфейса или пример другого инструмента, использующего эту функцию. | |
| 54 | + | ||
| 55 | + | ### Улучшение | |
| 56 | + | ||
| 57 | + | - Если вы реализовали новую функцию в исходном коде или улучшили документацию в файлах XML, создайте патч - см. [[Creating A Patch/ru|Создание исправления]]. | |
| 58 | + | - Если вы улучшили перевод в языковом .po-файле, приложите весь .po-файл (а не diff). | |
| 59 | + | - Если у вас есть другой файл ресурса, например значок, прикрепите его к сообщению. | |
| 60 | + | ||
| 61 | + | ### Перевод сообщений на английский язык | |
| 62 | + | ||
| 63 | + | Ошибки следует описывать на английском языке. Если английским Вы владеете недостаточно хорошо, то Вы можете использовать online переводчики (например: <http://translate.google.com/>). | |
| 64 | + | ||
| 65 | + | При описании ошибки, следует указать, что Вы пользовались переводчиком: "Sorry for my English, I'm using translator" | |
| 66 | + | ||
| 67 | + | Вы так же можете попросить помощи в переводе (и не только) на этом форуме: <http://freepascal.ru> | |
| 68 | + | ||
| 69 | + | ## Вложения | |
| 70 | + | ||
| 71 | + | Если вы добавляете вложения исходного кода или примера проекта для отчета об ошибке (**настоятельно рекомендуется**, см. [[Tips on writing bug reports|Советы по написанию отчетов об ошибках]]), пожалуйста, заархивируйте их, используя предпочтительно эти форматы: | |
| 72 | + | ||
| 73 | + | - zip (.zip) | |
| 74 | + | - gzip (.gz) | |
| 75 | + | - tar.gzip (.tgz/.tar.gz) | |
| 76 | + | ||
| 77 | + | Другие форматы, такие как 7zip, Bzip и RAR, тоже подходят. В настоящее время инструменты для них легко доступны. | |
| 78 | + | ||
| 79 | + | ## Понимание Report Status(статуса сообщения) | |
| 80 | + | ||
| 81 | + | Проблема может иметь следующие состояния: | |
| 82 | + | ||
| 83 | + | - Open, but no assignee(s) (открыта, но без правопреемника(ов)): никому не поручена. | |
| 84 | + | - Open and 1 or more assignees (открыта и 1 или более уполномоченных): проблема была поручена одному или нескольким разработчикам Lazarus, которые попытаются исправить/реализовать ее. | |
| 85 | + | - Проблема имеет метку "Status: Confirmed" (Статус: Подтверждено): член команды Lazarus продублировал ошибку или согласен с тем, что функция должна быть реализована | |
| 86 | + | - Проблема имеет пометку "Status: Feedback"(Статус: обратная связь): репортер должен оставить отзыв, чтобы ответить на любые вопросы, заданные командой Lazarus, или подтвердить, что проблема устранена удовлетворительно. | |
| 87 | + | - Closed(Закрыта): правопреемник закрыл (и предположительно исправил или отклонил) проблему. | |
| 88 | + | ||
| 89 | + | ## См.также | |
| 90 | + | ||
| 91 | + | - [[Tips on writing bug reports|Советы по написанию отчетов об ошибках]] | |
| 92 | + | - [[Creating A Patch]] Если вы изменили исходный код для реализации решения, эта статья поможет вам наиболее эффективно добавить его в отчет об ошибках, чтобы разработчики могли как можно быстрее добавить его в основной код. | |
| 93 | + | - [[Database bug reporting]] Специальная информация и примеры программ для ошибок базы данных | |
| 94 | + | - [[Moderating the bug tracker]] | |
| 95 | + | - Следующая страница содержит полезные советы о том, [как эффективно сообщать об ошибках](http://www.chiark.greenend.org.uk/~sgtatham/bugs.html). | |
| 96 | + | ||
| 97 | + | --- | |
| 98 | + | *From the Free Pascal wiki, page "How do I create a bug report/ru", as it stood on 2022-06-15 after a change by Zoltanleo, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |