Skip to content

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 <noreply@anthropic.com>
- 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 <noreply@anthropic.com>
- 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 <noreply@anthropic.com>
- 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 <noreply@anthropic.com>
- 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 <noreply@anthropic.com>
@TheHandyOwl TheHandyOwl added the translation-update This PR contains translations for the docs label Jun 25, 2025
@TheHandyOwl TheHandyOwl requested a review from 0xTim June 25, 2025 06:11
Copy link
Member

@0xTim 0xTim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@0xTim 0xTim merged commit 22de820 into vapor:main Jun 25, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

translation-update This PR contains translations for the docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants