docs: deepen tenancy + menus guides; natural KO phrasing#64
Merged
Conversation
Beginner-grade rewrite of the multi-tenancy and dynamic-menus guides to tutorial-level depth, matching the verified runtime APIs. tenancy: - single vs multi mode table; resolver table (fixed/header/jwt/subdomain) with a header curl example - TenantContextHolder.current() usage in an InvoiceService - tenant-scoped @entity + repository pattern (findByTenantId) - a custom TenantResolver bean (ApiKeyTenantResolver) - admin-console + configuration cross-links menus: - mental-model diagram (define once -> kit filters -> you render) - Step 1 define an item: console + REST tabs with the real CreateMenuRequest fields (code/label/path/icon/requiredPermission/ displayOrder/parentId) - Step 2 /api/nav serving via MenuProvider.menusFor + the MenuTree JSON shape; Step 3 a minimal Vue render snippet - caching + direction-of-dependency notes Both guides EN + KO, full file paths in every code block. Phrasing/anchors: - replace literal "0에서 실행까지" (zero-to-running) with natural Korean in the tutorial title, admin-console link, and mkdocs ko nav - pin ASCII anchors { #menus } { #tenants } on admin-console.ko.md and { #abac-policies } on access.ko.md so EN-style fragment links resolve in the KO build (Korean is stripped from auto-slugs); fix the pre-existing access.md#abac-정책 broken link in admin-console.ko.md Verification: mkdocs build --strict clean, no anchor/link warnings.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
EN
Deepens the Multi-tenancy and Dynamic Menus guides to the same beginner, step-by-step depth as the tutorial, and fixes awkward literal-translation Korean.
Multi-tenancy (
guides/tenancy)singlevsmultimode table + when to use eachfixed/header/jwt/subdomain) with a headercurlTenantContextHolder.current()used in a realInvoiceService@Entity+ repository pattern (findByTenantId)TenantResolverbean (ApiKeyTenantResolver)Dynamic Menus (
guides/menus)CreateMenuRequestfields (code/label/path/icon/requiredPermission/displayOrder/parentId)/api/navviaMenuProvider.menusFor(...)+ the actualMenuTreeJSON shapeBoth guides EN + KO, with full file paths in every code block.
Phrasing / anchors
0에서 실행까지("zero to running") with natural Korean in the tutorial title, the admin-console link, and the mkdocs ko nav{ #menus }{ #tenants }(admin-console.ko) and{ #abac-policies }(access.ko) so EN-style fragment links resolve in the KO build — Korean is stripped from the auto-slug — and fixed the pre-existing brokenaccess.md#abac-정책linkVerification:
mkdocs build --strict— clean, no anchor/link warnings.KO (한국어)
멀티테넌시·동적 메뉴 가이드를 튜토리얼과 같은 초보자용 step-by-step 깊이로 보강하고, 어색한 직역 한국어를 자연스럽게 고쳤습니다.
멀티테넌시 (
guides/tenancy)singlevsmulti모드 표 + 언제 무엇을fixed/header/jwt/subdomain) + 헤더curl예InvoiceService에서TenantContextHolder.current()사용@Entity+ 리포지토리 패턴(findByTenantId)TenantResolver빈(ApiKeyTenantResolver)동적 메뉴 (
guides/menus)CreateMenuRequest필드 포함MenuProvider.menusFor(...)로/api/nav+ 실제MenuTreeJSON 형태두 가이드 모두 한/영, 모든 코드 블록에 전체 파일 경로.
표현 / 앵커
0에서 실행까지를 자연스러운 한국어로 교체{ #menus }{ #tenants }(admin-console.ko)·{ #abac-policies }(access.ko)를 고정하고, 기존에 깨져 있던access.md#abac-정책링크를 수정검증:
mkdocs build --strict— clean, 앵커/링크 경고 없음.