index.md

layout	title
index	Scala Style Guide

Contents

• Overview
• Indentation
  • Line Wrapping
  • Methods with Numerous Arguments
• Naming Conventions
  • Classes/Traits
  • Objects
  • Packages
    • Versions Prior to 2.8
  • Methods
    • Accessors/Mutators
    • Parentheses
    • Symbolic Method Names
  • Values, Variables, and Methods
  • Type Parameters (Generics)
    • Higher-Kinds and Parameterized Type Parameters
  • Annotations
  • Special Note on Brevity
• Types
  • Inference
    • Function Values
    • "Void" Methods
  • Annotations
  • Ascription
  • Functions
    • Arity-1
  • Structural Types
• Nested Blocks
  • Curly Braces
  • Parentheses
• Declarations
  • Classes
    • Ordering of Class Elements
    • Methods
      • Modifiers
      • Body
      • Multiple Parameter Lists
      • Higher-Order Functions
    • Fields
  • Function Values
    • Spacing
    • Multi-Expression Functions
• Control Structures
  • Curly-Braces
  • Comprehensions
  • Trivial Conditionals
• Method Invocation
  • Arity-0
  • Suffix Notation
  • Arity-1
  • Higher-Order Functions
  • Symbolic Methods / Operators
• Files
  • Multi-Unit Files
• Scaladoc
  • General Style
  • Packages
  • Classes, Objects, and Traits
    • Classes
    • Objects
    • Traits
  • Methods and Other Members

About

This document is intended to outline some basic Scala stylistic guidelines which should be followed with more or less fervency. Wherever possible, this guide attempts to detail why a particular style is encouraged and how it relates to other alternatives. As with all style guides, treat this document as a list of rules to be broken. There are certainly times when alternative styles should be preferred over the ones given here.

Thanks to

Daniel Spiewak and David Copeland for putting this style guide together, and Simon Ochsenreither for converting it to markdown.