Как сообщать об ошибках

Если в проекте Nacos есть ошибки или ошибки в документации, сообщите нам об этом, [создав задачу][Nacos-issue]. Мы относимся к ошибкам и недочётам очень серьёзно и считаем, что нет незначительных проблем.

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

Чтобы сделать отчёт об ошибке точным и понятным, попробуйте создать отчёты об ошибках, которые:

• Конкретны. Включайте как можно больше деталей: какая версия, какая среда, какая конфигурация и т. д. Если ошибка связана с работой сервера Nacos, приложите журнал Nacos (особенно важен начальный журнал с конфигурацией Nacos).

• Воспроизводимы. Укажите шаги для воспроизведения проблемы. Мы понимаем, что некоторые проблемы могут быть трудно воспроизводимыми, поэтому укажите шаги, которые могут привести к проблеме. Если возможно, приложите к отчёту об ошибке затронутый каталог данных Nacos и трассировку стека.

• Уникальны. Не дублируйте существующие отчёты об ошибках.

Возможно, стоит прочитать статью Элизы Этемад о том, как правильно составлять отчёты об ошибках filing-good-bugs, прежде чем создавать собственный отчёт.

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

Как подавать отчёты об ошибках

Если у проекта Nacos есть какие-либо проблемы или проблемы с документацией, пожалуйста, сообщите нам через [создание задачи][Nacos-issue]. Мы очень серьёзно относимся к ошибкам и недостаткам, и для нас нет неважных вопросов. Однако перед созданием отчёта об ошибке проверьте, нет ли уже задачи с сообщением о такой же проблеме.

Для того чтобы отчёт об ошибке был точным и лёгким для понимания, попробуйте составить следующие отчёты об ошибках:

• Конкретные. Включают как можно больше подробностей: какая версия, какое окружение, какая конфигурация и так далее. Если проблема связана с работой Nacos-сервера, добавьте журнал Nacos (начальный журнал с конфигурацией Nacos особенно важен).

• Повторяемые. Указывают шаги для повторения проблемы. Мы понимаем, что некоторые вопросы могут быть трудными для повторения, поэтому включите шаги, которые могли бы привести к этой проблеме. При возможности добавьте в отчёт о проблеме затронутый каталог данных Nacos и трассировку стека.

• Неповторяющиеся. Не копируйте уже существующие отчёты о проблемах.

Перед составлением отчёта о проблеме рекомендуется прочитать статью Элизы Этемед о том, как подавать хорошие отчёты о проблемах [на архив хороших ошибок], это может дать вам вдохновение.

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