We love your input! We want to make contributing to NETCore.Keycloak as easy and transparent as possible, whether it's:

• Reporting a bug
• Discussing the current state of the code
• Submitting a fix
• Proposing new features
• Becoming a maintainer

We use GitHub to host code, to track issues and feature requests, as well as accept pull requests.

All branch names must follow this format:

This means:

• Start with one of these prefixes: feature/, bugfix/, hotfix/, docs/, refactor/
• Followed by a description that:
  • Is 5-50 characters long
  • Uses only lowercase letters (a-z), numbers (0-9), and underscores (_)
  • No spaces, hyphens, or special characters allowed

Examples:

• feature/add_token_refresh
• bugfix/fix_auth_flow_123
• hotfix/security_patch_456
• docs/update_readme_789
• refactor/simplify_code_101

1. Fork the repo and create your branch from main following the branch naming convention
2. Ensure your code follows the existing code style and formatting rules defined in .editorconfig
3. Update the documentation if needed
4. Ensure all tests pass
5. Create a Pull Request with a clear title and description

We use .editorconfig to maintain consistent coding styles. Some key points:

• Use tabs for indentation
• Maximum line length is 120 characters
• UTF-8 encoding
• Trim trailing whitespace
• Insert final newline
• Follow C# naming conventions
• Use proper spacing and bracing rules as defined in .editorconfig

• All public APIs must be documented using XML documentation comments
• Documentation should follow the standard XML format:
  ///

  
  /// Brief description of what the method/class does
  ///

  
  /// Description of the parameter
  /// Description of the return value
  /// When the exception is thrown
• Include code examples in documentation when the usage is not immediately obvious
• Keep comments up to date with code changes
• Use clear and concise language
• Document non-obvious implementation details or business logic
• Include references to related documentation or external resources when applicable

• Use the present tense ("Add feature" not "Added feature")
• Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
• Limit the first line to 72 characters or less
• Reference issues and pull requests liberally after the first line

• Never commit sensitive information (API keys, credentials, etc.)
• Follow SAST (Static Application Security Testing) rules defined in .editorconfig
• Report security vulnerabilities privately to the maintainers

By contributing, you agree that your contributions will be licensed under the same license as the project.

Don't hesitate to open an issue for any questions or concerns.