Skip to content

Update Japanese translations and fix heading anchors for documentation #1084

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 28 commits into
base: main
Choose a base branch
from

Conversation

lemo-nade-room
Copy link
Contributor

@lemo-nade-room lemo-nade-room commented Jun 19, 2025

This PR contains comprehensive updates to Japanese translations across the Vapor documentation, along with fixes for heading anchors to ensure proper cross-language navigation.

Summary of changes

1. Translation updates (27 files)

  • Updated Japanese translations to match the latest English documentation
  • Improved translation quality and consistency across all sections
  • Fixed typos and grammatical errors (e.g., 'ミッドウェア' → 'ミドルウェア')
  • Updated technical terms and code examples to match English version

2. Heading anchor fixes

  • Added explicit anchors to Japanese headings to match English auto-generated anchors
  • Removed unnecessary anchors from pure English headings in Japanese files
  • Ensured all heading anchors match between language versions for proper navigation

3. Structural alignment

  • Removed "Stack Traces" section from errors.ja.md to match English structure
  • Updated routing parameter syntax (.get.req.parameters.get)
  • Fixed method parameter names (e.g., type:redirectType:)

Sections updated

  • Getting Started: hello-world, folder-structure, spm, xcode
  • Basics: async, client, content, environment, errors, logging, routing, validation, controllers
  • Fluent: overview, migration, advanced, model, query, relations, schema
  • Install: linux, macos
  • Leaf: getting-started, overview, custom-tags
  • Security: passwords, authentication, crypto
  • Advanced: server, sessions, testing, tracing
  • Deploy: systemd, digital-ocean, heroku
  • Other: index, contributing, upgrading, redis/sessions

Testing

  • All Playwright cross-language navigation tests pass
  • Manual verification of translations and heading anchors
  • No changes to English documentation or non-documentation files

Commits included

27 commits updating translations + 1 commit fixing heading anchors (total: 28 commits)

lemo-nade-room and others added 28 commits June 18, 2025 22:09
- Add missing Testing section with AsyncTestQueuesDriver documentation
- Add reference to Romain Pouclet's blog post about testing Vapor Queues
- Complete translation to match English version
- Add missing Get section explaining try await future.get() usage
- Add deprecation warning for wait() method
- Complete translation to match English version
- Fix 'Future' translation (将来的に → Futureとして)
- Translate English comments to Japanese
- Remove unnecessary colons from text
- Improve consistency with English version
- Remove extra blank line to match English version
- Fix spacing after 'in' in code examples
- Fix full-width spaces around 'Content'
- Correct 'Contents' typo to 'Content'
- Fix 'coder' to 'コーダー'
- Remove full-width space after 'await'
- Fix defer block formatting to match English version
- Add proper indentation in entrypoint.swift example
- Fix table header typo: 'nama' to 'name'
- Ensure consistency with English documentation
- Fix typo: 'rep.parameters.get' to 'req.parameters.get'
- Fix typo: '確心' to '確信'
- Complete error message translation (413 Payload Too Large)
- Fix '広報互換性' to '後方互換性'
- Update redirect method parameter: 'type:' to 'redirectType:'
- Update redirect type: 'RedirectType' to 'Redirect'
- Fix 'ミッドウェア' to 'ミドルウェア'
- Add missing Custom validator section (lines 293-333)
- Fix ASCII typo: 'ASCⅡ' to 'ASCII' (full-width to half-width)
- Add '.custom(_:)' entry to validators table
- Complete translation to match English version
- Update GitHub documentation link to Japanese version
- Change from English to Japanese GitHub docs for pull request creation
- Update internal documentation link to use relative path without .ja.md
- Maintain consistency with documentation linking convention
- Update internal link to use relative path without .ja.md extension
- Follow documentation linking convention
- Update internal links to use relative paths without .ja.md extension
- Maintain consistency with documentation linking convention
- Update internal links to use relative paths without .ja.md extension
- Follow documentation linking convention
- Update internal link to use relative path without .ja.md extension
- Maintain documentation linking consistency
- Update Swift version requirement notice to match English version
- Fix async/await note formatting and add macOS 12 reference
- Add VSCode extension recommendation
- Update internal links to use relative paths without .ja.md extension
- Update SwiftPM documentation links to latest versions
- Fix spacing and formatting consistency
- Update Swift Language Server Protocol description
- Update Xcode interface terminology for consistency
- Ensure alignment with latest Xcode version
- Update internal links to use relative paths without .ja.md extension
- Maintain documentation linking convention for homepage
- Fix typo: 'Swifty' to 'Swiftly'
- Fix spacing: 'EPEL8' to 'EPEL 8'
- Add Homebrew installation option for Toolbox
- Update Toolbox description to match English version
- Update next steps link formatting
- Update Toolbox description to match English version
- Add Makefile installation option for Toolbox
- Improve consistency with English documentation
- Update next steps link formatting
- Add async/await support documentation and examples
- Update internal links to use relative paths
- Ensure consistency with English documentation structure
- Update internal link to use relative path without .ja.md extension
- Maintain documentation linking consistency
- Update internal links to use relative paths without .ja.md extension
- Ensure cross-references are consistent with other sections
- Add explicit anchors to Japanese headings to match English version
- Fix 21 heading anchors to ensure consistent cross-language navigation
- Japanese headings now have explicit anchors (e.g., ## 概要 {#overview})
- English-only headings remain without explicit anchors as they auto-generate

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Add explicit anchors to Japanese headings to match English version
- Fix 15 heading anchors to ensure consistent cross-language navigation
- Japanese headings now have explicit anchors (e.g., ## 概要 {#overview})
- Maintain consistent URL structure between English and Japanese versions

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Add explicit anchors to Japanese headings to match English version
- Fix 14 heading anchors to ensure consistent cross-language navigation
- Add missing heading "### Extending Validation API {#extending-validation-api}"
- Japanese headings now have explicit anchors (e.g., ## はじめに {#introduction})

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Add explicit anchors to Japanese headings to match English version
- Fix 9 heading anchors to ensure consistent cross-language navigation
- Japanese headings now have explicit anchors (e.g., ## ロガー {#logger})
- Maintain consistent URL structure between English and Japanese versions

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Add explicit anchors to Japanese headings to match English auto-generated anchors
- Remove unnecessary anchors from pure English headings in Japanese files
- Delete Stack Traces section from errors.ja.md to match English structure
- Ensure all heading anchors match between English and Japanese versions
- All Playwright cross-language navigation tests now pass

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@lemo-nade-room lemo-nade-room requested a review from a team as a code owner June 19, 2025 00:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant