docs(repo): update docs on authorization

[johanbook]

No description provided.

[codecov]

Codecov Report

Merging #377 (1900a13) into main (ac06e13) will increase coverage by 10.05%.
Report is 2 commits behind head on main.
The diff coverage is 68.42%.

@@             Coverage Diff             @@
##             main     #377       +/-   ##
===========================================
+ Coverage   39.07%   49.12%   +10.05%     
===========================================
  Files         421      183      -238     
  Lines        3836     1954     -1882     
  Branches      250      102      -148     
===========================================
- Hits         1499      960      -539     
+ Misses       2237      963     -1274     
+ Partials      100       31       -69     

Flag	Coverage Δ
api	49.12% <68.42%> (+0.46%)	⬆️
auth-api	?
homepage	?
tracking	?
web-ui	?

Flags with carried forward coverage won't be shown. Click here to find out more.

Files Changed	Coverage Δ
...ication/contracts/dtos/current-organization.dto.ts	0.00% <ø> (ø)
...lication/contracts/dtos/organization-member.dto.ts	100.00% <ø> (ø)
...ent/controllers/current-organization.controller.ts	0.00% <0.00%> (ø)
...features/organizations/organization.permissions.ts	0.00% <0.00%> (ø)
...rc/core/authorization/client/guards/roles.guard.ts	38.46% <50.00%> (+38.46%)	⬆️
...ors/requires-organization-permissions.decorator.ts	75.00% <75.00%> (ø)
.../src/core/authorization/organization-roles.enum.ts	100.00% <100.00%> (ø)
...n/contracts/commands/update-member-role.command.ts	100.00% <100.00%> (ø)
...anizations/domain/services/organization.service.ts	92.30% <100.00%> (+0.20%)	⬆️
...ructure/entities/organization-membership.entity.ts	100.00% <100.00%> (ø)

... and 239 files with indirect coverage changes