Contributor documentation

[albi005]

Git

• Split large PRs
  • Create supporting PR, then redirect the PR into it (draft?)
  • git cherry-pick
• add setup instructions when requesting a review

Creating Modules

• Do copy from other Modules. Add a TODO to refactor if sensible.

Auth

• scheme/scheme handler/requirement/requirement handler/policy/operation authz requirement

authentication: creates a ClaimsPrincipal
authorization: reads a ClaimsPrincipal

Database

• EF bypasses init on auto-properties
• adding database connections in rider

Troubleshooting

• cant inject/construct scoped service

• when in doubt, go to definition

  • available everywhere in .NET, make sure SourceLink is set up and working

Blazor

• EmitCompilerGeneratedFiles
  • obj/**/generated
• EventHandlers triggering rerendering on the defining component

JavaScript

• install dependencies using npm install?
  • no, dotnet build does it automatically if you have bun

Push notifications

• RFC8030: Generic Event Delivery Using HTTP Push