Code Guidelines

Naming Conventions

• Types: PascalCase
  • Prefix interfaces with "I"
  • Suffix delegates with "Del"
• Methods: PascalCase
• Non-Private Members: PascalCase
• Private Members: _camelCase

Code Design

• One type per file with the exception of nested types and delegate declarations.
• No public fields except for consts, use properties instead
• No stateful static types. These are a pain to clean up, static types should not store any information.
• Use dependency injection when possible. Most Torch code uses constructor injection.
• Events and actions should be null checked before calling or invoked with the action?.Invoke() syntax.

Documentation

• All types and members not marked private or internal should have XML documentation using the /// <summary> tag.
  • Interface implementations and overridden methods should use the /// <inheritdoc /> tag unless the summary needs to be changed.