Как внести свой вклад

Самый простой способ внести свой вклад — это открыть вопрос и начать обсуждение. Затем мы сможем решить, можно ли реализовать функцию или изменение, и следует ли вам отправить запрос на включение изменений кода (pull request).

Общие вопросы о токен-базированной аутентификации и архитектуре?

Мы отслеживаем тег identityserver3 на StackOverflow.

Обратная связь и вопросы?

Пожалуйста, начните обсуждение в системе отслеживания проблем основного репозитория core repo issue tracker.

Ошибки и запросы функций?

Пожалуйста, создайте новую проблему в соответствующем репозитории GitHub:

• Core
• WS-Federation plugin
• EntityFramework support
• ASP. NET Identity support
• MembershipReboot support
• AccessToken validation
• Samples

Из-за безопасности IdentityServer ошибки очень расплывчаты. Перед тем как открыть отчёт об ошибке или проблеме, убедитесь, что вы прочитали и поняли, как включить логирование.

Пообщайтесь с нами и другими пользователями identityserver

https://gitter.im/IdentityServer/IdentityServer3

Создание проблем

Лучший способ исправить вашу ошибку — предоставить как можно больше подробностей о проблеме. Идеально предоставить минимальный проект с шагами для воспроизведения проблемы. Вот вопросы, на которые вы можете ответить перед созданием отчёта об ошибке, чтобы убедиться, что вы не пропустили какую-либо важную информацию.

1. Вы читали документацию?
2. Вы включили фрагмент неработающего кода в проблему?
3. Каковы ТОЧНЫЕ шаги для воспроизведения этой проблемы?

GitHub поддерживает markdown, поэтому при создании отчётов об ошибках убедитесь, что вы проверили форматирование перед отправкой.

Вклад кода и контента

Вам нужно будет подписать Лицензионное соглашение участника перед отправкой вашего запроса на включение (pull request).

Убедитесь, что вы можете собрать код. Ознакомьтесь с рабочим процессом проекта и нашими соглашениями о кодировании. Если вы не знаете, что такое запрос на включение, прочитайте эту статью: https://help.github.com/articles/using-pull-requests.

Мы принимаем PR только в ветке dev.

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

• Этикет открытого исходного кода Open Source Contribution Etiquette Мигеля де Иказы
• Не «толкайте» свои запросы на включение Don't "Push" Your Pull Requests Ильи Григорика.
• 10 советов по улучшению запросов на включение [10 tips for better Pull Requests](http://blog.ploeh.dk/2015/01/15/10-tips-for-better-pull-requests/] Марка Симанна
• Как написать идеальный запрос на включение How to write the perfect pull request от GitHub

Вот несколько вещей, которые вы всегда должны делать при внесении изменений в кодовую базу:

Формат запроса на включение/коммита

Summary of the changes (Less than 80 chars)
 - Detail 1
 - Detail 2

#bugnumber (in this specific format)

Тесты

• Тесты нужны для каждой завершённой функции или ошибки.
• Тесты необходимы только для задач, требующих проверки QA (например, не для задач).
• Если есть сценарий, который слишком сложно протестировать, тест для него не нужен.
• «Слишком сложно» определяется всей командой.

Пакеты вклада

Если вы планируете добавить функциональность через пакеты вклада, мы хотели бы, чтобы вы использовали IdentityServer3.Contrib.*. В качестве соглашения об именовании.