docs: Add Auth Docs #307

Merged
csimonis merged 2 commits from docs/auth into main 2025-06-11 12:02:25 +00:00
Owner
No description provided.
csimonis added 1 commit 2025-06-11 11:51:34 +00:00
docs: Add API and JWT acronyms to documentation
All checks were successful
CI / Get Changed Files (pull_request) Successful in 9s
CI / Backend Tests (pull_request) Has been skipped
CI / Checkstyle Main (pull_request) Has been skipped
CI / Docker frontend validation (pull_request) Has been skipped
Pull Request Labeler / labeler (pull_request_target) Successful in 10s
CI / eslint (pull_request) Has been skipped
CI / oxlint (pull_request) Has been skipped
CI / Docker backend validation (pull_request) Has been skipped
CI / prettier (pull_request) Has been skipped
Label PRs based on size / Check PR size (pull_request) Successful in 14s
CI / Playwright (pull_request) Has been skipped
CI / test-build (pull_request) Has been skipped
Claude PR Review / claude-code (pull_request) Successful in 1m41s
51d21bc3ee
forgejo-actions added the
size
small
label 2025-06-11 11:51:53 +00:00
ptran approved these changes 2025-06-11 11:52:34 +00:00
Dismissed
Collaborator

Code Review Feedback

I've reviewed the authentication documentation changes. The content is well-structured and comprehensive, but there are several issues that need to be addressed:

Issues to fix:

  1. projektdokumentation/Inhalt/Auth.tex:3 - Typo: "Erfolgreicher" should be "erfolgreicher" (lowercase)

  2. projektdokumentation/Inhalt/Auth.tex:4 - Grammar error: "zwei verschiedene Wege ab" should be "drei verschiedene Wege ab" since you describe three authentication methods, not two

  3. projektdokumentation/Inhalt/Auth.tex:6 - Typo: "validitert" should be "validiert"

  4. projektdokumentation/Inhalt/Auth.tex:8 - Technical inaccuracy: The description suggests the API gets a JWT from the OAuth provider, but OAuth providers typically return access tokens, not necessarily JWTs. Consider clarifying this distinction.

  5. projektdokumentation/Abkuerzungen.tex:35 - There's already a commented API definition on line 16. Consider removing the comment or placing the new definition in a more logical order.

  6. projektdokumentation/Inhalt.tex:3 - Missing newline at end of file

Positive aspects:

  • Good documentation structure with clear section labeling
  • Comprehensive coverage of authentication methods
  • Proper use of LaTeX acronym system

Please address these issues before merging.

## Code Review Feedback I've reviewed the authentication documentation changes. The content is well-structured and comprehensive, but there are several issues that need to be addressed: **Issues to fix:** 1. **projektdokumentation/Inhalt/Auth.tex:3** - Typo: "Erfolgreicher" should be "erfolgreicher" (lowercase) 2. **projektdokumentation/Inhalt/Auth.tex:4** - Grammar error: "zwei verschiedene Wege ab" should be "drei verschiedene Wege ab" since you describe three authentication methods, not two 3. **projektdokumentation/Inhalt/Auth.tex:6** - Typo: "validitert" should be "validiert" 4. **projektdokumentation/Inhalt/Auth.tex:8** - Technical inaccuracy: The description suggests the API gets a JWT from the OAuth provider, but OAuth providers typically return access tokens, not necessarily JWTs. Consider clarifying this distinction. 5. **projektdokumentation/Abkuerzungen.tex:35** - There's already a commented API definition on line 16. Consider removing the comment or placing the new definition in a more logical order. 6. **projektdokumentation/Inhalt.tex:3** - Missing newline at end of file **Positive aspects:** - Good documentation structure with clear section labeling - Comprehensive coverage of authentication methods - Proper use of LaTeX acronym system Please address these issues before merging.
csimonis added 1 commit 2025-06-11 11:53:45 +00:00
add pdf to gitignore
All checks were successful
CI / Get Changed Files (pull_request) Successful in 8s
Pull Request Labeler / labeler (pull_request_target) Successful in 6s
CI / eslint (pull_request) Has been skipped
CI / oxlint (pull_request) Has been skipped
CI / prettier (pull_request) Has been skipped
CI / Backend Tests (pull_request) Has been skipped
Label PRs based on size / Check PR size (pull_request) Successful in 13s
CI / test-build (pull_request) Has been skipped
CI / Checkstyle Main (pull_request) Has been skipped
CI / Docker frontend validation (pull_request) Has been skipped
CI / Docker backend validation (pull_request) Has been skipped
CI / Playwright (pull_request) Has been skipped
Claude PR Review / claude-code (pull_request) Successful in 1m4s
82db59bf51
csimonis dismissed ptran's review 2025-06-11 11:53:45 +00:00
Reason:

New commits pushed, approval review dismissed automatically according to repository settings

Collaborator

Code Review Feedback:

Found several issues that should be addressed:

projectdokumentation/Abkuerzungen.tex:16-18: Inconsistent acronym organization - API acronym is commented out then re-added at the end. Please maintain alphabetical order.

projektdokumentation/Deckblatt.tex:27: Missing newline at end of file.

projektdokumentation/Inhalt.tex:3: Missing newline at end of file - this can cause LaTeX compilation issues.

projektdokumentation/Inhalt/Auth.tex:6: Grammar error - 'validitert' should be 'validiert'.

projektdokumentation/Inhalt/Auth.tex:7: Consider using 'Verifizierungs-E-Mail' for consistency.

projektdokumentation/Inhalt/Auth.tex:8: The OAuth explanation is a very long sentence - consider splitting for better readability.

The documentation content is good and well-structured. Please address these formatting and grammar issues.

**Code Review Feedback:** Found several issues that should be addressed: **projectdokumentation/Abkuerzungen.tex:16-18**: Inconsistent acronym organization - API acronym is commented out then re-added at the end. Please maintain alphabetical order. **projektdokumentation/Deckblatt.tex:27**: Missing newline at end of file. **projektdokumentation/Inhalt.tex:3**: Missing newline at end of file - this can cause LaTeX compilation issues. **projektdokumentation/Inhalt/Auth.tex:6**: Grammar error - 'validitert' should be 'validiert'. **projektdokumentation/Inhalt/Auth.tex:7**: Consider using 'Verifizierungs-E-Mail' for consistency. **projektdokumentation/Inhalt/Auth.tex:8**: The OAuth explanation is a very long sentence - consider splitting for better readability. The documentation content is good and well-structured. Please address these formatting and grammar issues.
csimonis force-pushed docs/auth from 82db59bf51 to 187ec1cd7c 2025-06-11 11:55:59 +00:00 Compare
ptran approved these changes 2025-06-11 11:56:34 +00:00
Dismissed
csimonis force-pushed docs/auth from 187ec1cd7c to 4619f787f0 2025-06-11 11:58:22 +00:00 Compare
csimonis dismissed ptran's review 2025-06-11 11:58:22 +00:00
Reason:

New commits pushed, approval review dismissed automatically according to repository settings

ptran approved these changes 2025-06-11 12:00:15 +00:00
csimonis merged commit 6737eb9e4a into main 2025-06-11 12:02:25 +00:00
csimonis deleted branch docs/auth 2025-06-11 12:02:26 +00:00
Commenting is not possible because the repository is archived.
No reviewers
No milestone
No project
No assignees
3 participants
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: SZUT/casino#307
No description provided.