Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Sep 12, 2025

This PR adds a complete English translation of chapter-08.md to the website.en/MarkDown/ directory, providing American English content for the international version of the programming best practices book.

Translation Overview

The translated chapter covers Practical Coding Techniques and includes:

  • Think Simple Philosophy: Complexity avoidance techniques including the Giraffe-Refrigerator Principle and Saibara's Principle
  • Intent Expression: Moving from How-focused to What-focused code with practical examples
  • Error Handling Optimization: Defensive programming, Design by Contract, Result types, and Option types
  • Performance vs Readability Balance: Optimization strategies, caching, lazy evaluation, and profiling techniques
  • Quality Judgment Criteria: Code review guidelines and assessment frameworks
  • Practical Exercise: Complete log analysis system implementation in C#

Technical Details

  • File size: 2,256 lines (matching original 2,257 lines)
  • Code examples: All preserved in original languages (C#, Java, Python, JavaScript) with translated comments
  • Diagrams: Mermaid diagrams maintained with English annotations
  • Images: References to ../Images/ work correctly with existing assets in website.en/Images/
  • Encoding: UTF-8 without BOM
  • Quality: No Japanese characters remain; complete professional translation

Content Validation

The translation maintains technical accuracy while converting all explanatory text, examples, and documentation to natural American English. All markdown formatting, code blocks, and structural elements are preserved exactly as in the original.

Fixes #183.


💡 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.

Copilot AI and others added 2 commits September 12, 2025 04:34
Co-authored-by: Fujiwo <3992360+Fujiwo@users.noreply.github.com>
Co-authored-by: Fujiwo <3992360+Fujiwo@users.noreply.github.com>
Copilot AI changed the title [WIP] chapter-08.md の英語版 2 Add English translation of chapter-08.md for website.en Sep 12, 2025
Copilot AI requested a review from Fujiwo September 12, 2025 04:42
Copilot finished work on behalf of Fujiwo September 12, 2025 04:42
@Fujiwo Fujiwo marked this pull request as ready for review September 12, 2025 04:51
Copilot AI review requested due to automatic review settings September 12, 2025 04:51
@Fujiwo Fujiwo merged commit 9e33a74 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 adds a complete English translation of Chapter 8 ("Practical Coding Techniques") to the international version of the programming best practices book. The translation covers comprehensive coding techniques including the "Think Simple" philosophy, intent-expressing programming, error handling optimization, and performance-readability balance strategies.

  • Complete translation of 2,256 lines covering practical coding methodologies
  • Technical accuracy maintained with all code examples preserved in original languages
  • Professional American English localization with natural language flow

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-08.md の英語版 2

2 participants