knsh14/uber-style-guide-ja

https://github.com/knsh14/uber-style-guide-ja/blob/master/guide.md# uber-style-guide-ja

https://github.com/knsh14/uber-style-guide-ja/blob/master/guide.md# About uber-go/guideの日本語訳

https://github.com/knsh14/uber-style-guide-ja/blob/master/guide.md# Table of Contents

• 導入
• ガイドライン
  • Pointers to Interfaces
  • Verify Interface Compliance
  • Receivers and Interfaces
  • Zero-value Mutexes are Valid
  • Copy Slices and Maps at Boundaries
    • Receiving Slices and Maps
    • Returning Slices and Maps
  • Defer to Clean Up
  • Channel Size is One or None
  • Start Enums at One
  • Use "time" to handle time
    • Use time.Time for instants of time
    • Use time.Duration for periods of time
    • Use time.Time and time.Duration with external systems
  • Errors
    • Error Types
    • Error Wrapping
    • Error Naming
    • Handle Errors Once
  • Handle Type Assertion Failures
  • Don't Panic
  • Use go.uber.org/atomic
  • Avoid Mutable Globals
  • Avoid Embedding Types in Public Structs
  • Avoid Using Built-in Names
  • Avoid init()
  • Exit in Main
    • Exit Once
  • Use field tags in marshaled structs
  • Don't fire-and-forget goroutines
    • Wait for goroutines to exit
    • No goroutines in init()
• Performance
  • Prefer strconv over fmt
  • Avoid string-to-byte conversion
  • Prefer Specifying Map Capacity Hints
• Style
  • Avoid overly long lines
  • Be Consistent
  • Group Similar Declarations
  • Import Group Ordering
  • Package Names
  • Function Names
  • Import Aliasing
  • Function Grouping and Ordering
  • Reduce Nesting
  • Unnecessary Else
  • Top-level Variable Declarations
  • Prefix Unexported Globals with _
  • Embedding in Structs
  • Local Variable Declarations
  • nil is a valid slice
  • Reduce Scope of Variables
  • Avoid Naked Parameters
  • Use Raw String Literals to Avoid Escaping
  • Initializing Structs
    • Use Field Names to Initialize Structs
    • Omit Zero Value Fields in Structs
    • Use var for Zero Value Structs
    • Initializing Struct References
  • Initializing Maps
  • Format Strings outside Printf
  • Naming Printf-style Functions
• Patterns
  • Test Tables
  • Avoid Unnecessary Complexity in Table Tests
    • Parallel Tests
  • Functional Options
• Linting
  • Lint Runners