morningman opened a new pull request, #4482:
URL: https://github.com/apache/doris-website/pull/4482

   Course lessons, release notes and community reports are outside automated 
translation discovery, so their additions and edits do not produce translation 
tasks. Extend the Japanese, Korean and Russian scopes to cover these content 
types, including the course landing page, Hackathon tasks and weekly report 
interface.
   
   Courses and releases reuse native Docusaurus document identities. Course 
props, TSX prose and weekly report exports use text-unit extraction and local 
assembly, with code, links, IDs and numbers protected. The build loader applies 
current reviewed translations at the original resource path. Ordinary pages 
become available as translated pages after their required interface/content 
groups are current.
   
   The existing Japanese/Korean schedules and Russian manual trigger continue 
using the shared discovery pipeline. This PR connects the sources and rendering 
path; translation candidates will be generated by the workflows after merge.
   
   ## Validation
   
   - All locale configurations pass `node scripts/i18n/check-configuration.cjs 
--all`.
   - `node --test scripts/i18n/__tests__/*.test.cjs`: 233 passed; the optional 
production-build test was run separately.
   - English and Japanese Docusaurus production fixture builds pass, rendering 
translated TSX and MDX report exports while preserving English output.
   - Every existing Doris 101 module, course/Hackathon source module and weekly 
report passes a mock translation round trip with protected-content checks.
   - A real read-only inventory/planner run at this commit discovers 121 
additional sources: 6 lessons, 83 release documents, 15 course/Hackathon 
modules, 16 reports and 1 report interface module. All five new groups have 
zero unregistered sources.
   - A schedule-mode discovery check using that inventory selects 
representative lesson, release, course UI, report body and report UI tasks and 
reports `can_generate=true`. No live model requests or translation workflow 
dispatches were made.
   - `git diff --check` passes.
   
   ## Review checkpoints
   
   1. Goal: discovery, planning, generation, open-PR reservations, admission 
and rendering accept the added content formats. Tests cover new source files 
and updates to an existing report.
   2. Scope: the additional source groups and text-unit adapter are needed 
because report exports and course UI are executable MDX/TSX rather than 
ordinary Markdown documents.
   3. Information architecture: existing document plugins, sidebars, versions 
and localized directory conventions remain authoritative. Supplemental modules 
create translation identities without adding public routes.
   4. Links and routing: public paths and weekly report hashes remain stable. 
Course landing links now use Docusaurus Link so lesson navigation retains the 
selected locale.
   5. Frontend: the existing responsive DOM, styles and semantic theme tokens 
are retained. SSR and client compilation pass in the production fixtures.
   6. Validation: automated tests, production fixtures and the real content 
inventory cover the changed pipeline. Generated articles will still receive 
normal translation PR checks and proofreading.
   7. Other issues: source freshness, ownership, escaping and 
executable-content checks are enforced before translated modules compile. 
Self-review found no additional correctness, accessibility, SEO or 
maintainability findings.
   
   ## Versions
   
   - [x] dev
   - [x] 4.x
   - [ ] 3.x
   - [ ] 2.1 or older (not covered by version/language sync gate)
   
   This is shared translation infrastructure plus unversioned course, release 
and report content scope; it does not edit versioned article text.
   
   ## Languages
   
   - [ ] Chinese
   - [x] English
   - [x] Japanese
   - [x] Korean
   - [x] Russian
   
   ## Docs Checklist
   
   - [x] Checked by AI
   - [x] Test Cases Built
   - [x] Updated required version and language counterparts, or explained why 
not
   - [x] If only one language changed, confirmed whether source/translation 
counterparts need sync
   
   All three managed locale scopes are updated together. The English developer 
guide describes the shared workflow; no article translations are included in 
this infrastructure change.
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to