Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Sep 12, 2025

This PR creates a complete English translation of appendix-b.md (Naming Conventions and Coding Standards Examples) for the website.en folder structure as requested.

Changes Made

  • Created: website.en/MarkDown/appendix-b.md - Complete English translation of the Japanese version
  • Translation Quality: All 875 lines of Japanese content translated to natural American English
  • Content Preserved: All technical content, code examples, tables, and markdown structure maintained exactly
  • Image Links: Updated to reference ../Images/banner-appendix-b.svg in the website.en structure
  • Encoding: File saved as UTF-8 without BOM as specified

Content Overview

The translated appendix covers comprehensive programming standards including:

  • Basic naming conventions for C#, Java, Python, and JavaScript/TypeScript
  • Domain-driven naming strategies using ubiquitous language
  • Coding convention examples with detailed file structure guidelines
  • Code quality checklists covering naming, structure, performance, security, and maintainability
  • Method design principles and exception handling standards
  • Comment and documentation best practices with language-specific examples

Validation Results

Zero Japanese characters remain - Validated using Python regex
American English conventions used throughout (color, organization, analyze)
Image references work - Banner image exists in website.en/Images/
Markdown structure preserved - Headers, code blocks, and tables intact
File encoding correct - UTF-8 without BOM
Complete translation - 872 lines covering all original content

The English version maintains complete fidelity to the original while using natural, consistent American English terminology throughout all technical explanations and guidelines.

Fixes #193.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: Fujiwo <3992360+Fujiwo@users.noreply.github.com>
Copilot AI changed the title [WIP] appendix-b.md の英語版 Create English version of appendix-b.md for website.en Sep 12, 2025
Copilot AI requested a review from Fujiwo September 12, 2025 06:46
Copilot finished work on behalf of Fujiwo September 12, 2025 06:46
@Fujiwo Fujiwo marked this pull request as ready for review September 12, 2025 06:46
Copilot AI review requested due to automatic review settings September 12, 2025 06:46
@Fujiwo Fujiwo merged commit 34e9e03 into main Sep 12, 2025
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR creates a complete English translation of the Japanese appendix-b.md file for the website.en folder structure. The translation provides comprehensive programming naming conventions and coding standards for multiple programming languages.

Key Changes

  • Complete English translation of 873 lines of Japanese technical documentation
  • Standardized American English conventions (color, organization, analyze) throughout
  • Updated image references to work within the website.en folder structure

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.

appendix-b.md の英語版

2 participants