Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Sep 11, 2025

This PR adds a complete English translation of chapter-02.md to the website.en folder structure, providing comprehensive coverage of naming best practices and principles for English-speaking readers.

What's Added

The translation includes all sections from the original Japanese chapter:

  • Chapter Overview: Purpose, learning objectives, and importance of naming
  • 2.1 Accountability: Code as self-documenting design communication
  • 2.2 Naming as Core of Modeling: The relationship between naming and software modeling
  • 2.3 Name and Conquer: Definitional conquest techniques for managing complexity
  • 2.4 Organizing Vocabulary: Creating domain-specific vocabularies through naming
  • 2.5 Service Oriented Naming (SON): Client-perspective naming strategies
  • 2.6 Anti-patterns and Countermeasures: Common naming mistakes and solutions
  • 2.7 Practical Exercises: Hands-on naming improvement techniques
  • 2.8 AI Era Naming Strategies: Integration with prompt engineering and AI collaboration

Translation Quality

  • Complete accuracy: 1,806 lines translated from 1,818 Japanese lines
  • American English conventions: Consistent spelling and terminology
  • Preserved structure: All Markdown formatting, code blocks, and image references maintained
  • Code comments translated: Technical examples localized while preserving code functionality
  • Image links updated: All references point to ../Images/ in the English site structure

Technical Validation

  • ✅ JavaScript syntax validation passed
  • ✅ Website accessibility confirmed (HTTP 200 OK)
  • ✅ Markdown rendering tested locally
  • ✅ All image references functional
  • ✅ Code examples with proper syntax highlighting

The English website now provides comprehensive access to advanced naming principles and practices, including modern AI-era considerations for prompt engineering and collaborative development.

Fixes #164.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: Fujiwo <3992360+Fujiwo@users.noreply.github.com>
Copilot AI changed the title [WIP] chapter-02.md の英語版 Add English translation of Chapter 2: The Importance of Naming and Best Practices Sep 11, 2025
Copilot AI requested a review from Fujiwo September 11, 2025 10:11
Copilot finished work on behalf of Fujiwo September 11, 2025 10:11
@Fujiwo Fujiwo marked this pull request as ready for review September 11, 2025 10:16
Copilot AI review requested due to automatic review settings September 11, 2025 10:16
@Fujiwo Fujiwo merged commit 498cb74 into main Sep 11, 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 adds a comprehensive English translation of Chapter 2, which focuses on the fundamental importance of naming in programming. The translation transforms advanced naming concepts, modeling techniques, and modern AI integration strategies from Japanese into accessible American English.

Key Changes

  • Complete chapter translation maintaining all technical concepts and pedagogical structure
  • Modernization of examples with contemporary C# syntax and patterns
  • Integration of AI-era naming strategies for prompt engineering and collaborative development

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.

chapter-02.md の英語版

2 participants