Clean C#
Clean C#
Readable, Maintainable, Pleasurable C#
About the Book
This book will help you write cleaner, more maintainable, more readable, and more pleasurable C# code.
About the Author
Table of Contents
-
About The Author
-
Other Leanpub Books by Jason Roberts
- Keeping Software Soft
- C# Tips
- Pluralsight Courses
-
Other Leanpub Books by Jason Roberts
- About this Book
-
Introduction
- What is Clean C#?
- Why Clean C#?
-
Using this Book
- Code Samples
- Order
- Prescriptive
- Clean C# is a Spectrum
-
Comments
- Repeating What the Code Already Says
- Change Control Comments
- Comments as a Substitute for Self Documenting Code
- Commented-Out Code
- Pointless XML Documentation Comments
- Acceptable Use of Comments
-
Naming Things
-
Qualities of Clean Names
- Expressive
- Accurate
- Suitable Length
- Pronounceable Names
-
Naming Specific Items
- Namespaces
- Interfaces
- Classes
- Methods
- Properties
- Events
- Fields
- Attributes
- Method Parameters
- Variables
- Booleans
- Generic Types Parameters
- Enums
- Some General Rules
-
Qualities of Clean Names
-
Methods
- Method Size and Clarity
- Cohesive Methods
- Mixing Abstraction Levels
- Action or Answering Methods
-
Method Parameters
- Methods with Zero Parameters
- Methods with One Parameter
- Methods with Two Parameters
- Methods with Three Parameters
- Methods with More Than Three Parameters
- Refactoring to Reduce the Number of Parameters
- Params
- Output Parameters
- Named Arguments
- Boolean Switching Arguments
- Multiple Returns
- Code Duplication in Methods
- Methods with Side Effects
-
Structuring Programs for Readability
- Levels of Abstraction
- Method Level Abstractions
-
Errors and Exceptions
- Returning Error Codes
-
Using Exceptions
- Supplied Framework Exceptions
- Defining Custom Exceptions
-
Alternatives to Error Codes, Exceptions, and Returning Nulls
- Try Methods
- Special Case Design Pattern
-
Visual Formatting
- The Principle of Proximity
- The Principal of Similarity
- The Principal of Uniform Connectedness
- The Principal of Symmetry
-
Cohesion and Coupling
- Cohesion
- Coupling
-
Clean Tests
-
Qualities of Good Test
- Execution Speed
- Independent and Isolated
- Repeatable and Reliable
- Valuable
- Resilient to Production Code Changes
-
The Three Logical Phases of Tests
- The Arrange Phase
- The Act Phase
- The Assert Phase
- How Many Asserts?
- Simplifying Arrange Phase code with AutoFixture
-
Qualities of Good Test
-
Building On Clean Code
- The Single Responsibility Principle (SRP)
- The Open Closed Principle (OCP)
- The Liskov Substitution Principle (LSP)
- The Interface Segregation Principle (ISP)
- Keep It Simple Stupid (KISS)
- Don’t Repeat Yourself (DRY)
- You Aren’t Gonna Need It (YAGNI)
Authors have earned$9,651,785writing, publishing and selling on Leanpub, earning 80% royalties while saving up to 25 million pounds of CO2 and up to 46,000 trees.
Learn more about writing on Leanpub
The Leanpub 45-day 100% Happiness Guarantee
Within 45 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.
See full terms
Free Updates. DRM Free.
If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).
Most Leanpub books are available in PDF (for computers), EPUB (for phones and tablets) and MOBI (for Kindle). The formats that a book includes are shown at the top right corner of this page.
Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.
Learn more about Leanpub's ebook formats and where to read them
Top Books
- #1
El Manual del Manager
Keyvan Akbary, Félix López, and Álvaro Salazar¿Has deseado alguna vez el haber tenido una buena introducción al rol del Engineering Manager? En este libro aprenderás lo necesario para ejercer el rol de una manera efectiva: Expectativas y Responsabilidades del Rol, 1-1s, Ayudar a Crecer, Objetivos, Planes de Carrera, Cultura, Feedback, Contratación, Cultura de Producto y mucho más.
- #2
Ansible for Kubernetes
Jeff GeerlingAnsible is a powerful infrastructure automation tool. Kubernetes is a powerful application deployment platform. Learn how to use these tools to automate massively-scalable, highly-available infrastructure.
- #3
Functional Design and Architecture
Alexander GraninSoftware Design in Functional Programming, Design Patterns and Practices, Methodologies and Application Architectures. How to build real software in Haskell with less efforts and low risks. The first complete source of knowledge.
- #4
CCIE Service Provider Version 4 Written and Lab Exam Comprehensive Guide
Nicholas RussoThe service provider landscape has changed rapidly over the past several years. Networking vendors are continuing to propose new standards, techniques, and procedures for overcoming new challenges while concurrently reducing costs and delivering new services. Cisco has recently updated the CCIE Service Provider track to reflect these changes; this book represents the author's personal journey in achieving that certification.
- #5
CCIE SP v4.1 - Workbook
Łukasz Bromirski, Piotr Jablonski, and Nicholas RussoAre you striving to prepare to and pass CCIE SP lab exam? Take the opportunity and get this workbook! With the attached initial cfg files you will prepare yourself for the CCIE SP exam as well as learn SP technologies applicable to all kinds of today modern networks! This workbook covers blueprint topics and provides challenging examples.
- #6
Ansible for DevOps
Jeff GeerlingAnsible is a simple, but powerful, server and configuration management tool. Learn to use Ansible effectively, whether you manage one server—or thousands.
- #7
Code Faster in Delphi
Alister ChristieThis book will make you a faster Delphi developer, it doesn't matter if you are just starting out, or have been using Delphi since version 1, you will find all sorts of tips, tricks and hacks to boost your productivity.
- #8
R Programming for Data Science
Roger D. PengThis book brings the fundamentals of R programming to you, using the same material developed as part of the industry-leading Johns Hopkins Data Science Specialization. The skills taught in this book will lay the foundation for you to begin your journey learning data science. Printed copies of this book are available through Lulu.
- #9
Composing Software
Eric ElliottAll software design is composition: the act of breaking complex problems down into smaller problems and composing those solutions. Most developers have a limited understanding of compositional techniques. It's time for that to change.
- #10
The Hundred-Page Machine Learning Book
Andriy BurkovEverything you really need to know in Machine Learning in a hundred pages.
Top Bundles
- #1
agile
11 Books
In this bundle, you will find 10 different agile books. They are about different aspects of being agile. - finding a job - doing coding dojo's - Retrospectives - Personal kanban - a non-typical coaching book and even a book that gives you an insight in the lives of some agile people. - #2
WTFlop 6M + HU - Beta Bundle
6 Books
- #3
Node Patterns
6 Books
- #4
Fifty Quick Ideas
3 Books
Get all three books for the price of two! Fifty Quick Ideas books are full of practical, real-world techniques that you can use to improve teamwork, build better products and build them in a better way. - #5
Growing Agile: Coach's Guide Series
4 Books
This bundle provides a collection of training and workshop plans for a variety of agile topics. The series is aimed at agile coaches, trainers and ScrumMasters who often find themselves needing to help teams understand agile concepts. Each book in the series provides the plans, slides, handouts and activity instructions to run a number of... - #6
Marionette.js A to Z
3 Books
Marionette.js has become a popular Backbone-based javascript library, because it helps you avoid boiler-plate code and focus on what makes your app special. But how do you get started?Whether you want to finally get started with dynamic client-side programming (like one reader did), or are an experienced front-end dev who has inherited a... - #7
Build A Better Backbone App
3 Books
The best way to learn new development skills is through experience, but that takes time you don't have.Get the best of both worlds with this bundle: you'll learn how to produce modern web applications by learning from experienced developers like Derick Bailey and David Sulc. BackboneJS is one of the favorite tools on the web today, but it... - #8
People Skills—Soft but Difficult
7 Books
Perhaps you've been told that "lack of people skills" has been holding you back. No wonder: you may have had hundreds of hours of technical training, but little or no "people skills" guidance.You've heard it said that people skills are "soft," whereas technical skills are "hard." For you, though, technical skills are "easy," but people skills... - #9
SurviveJS - Webpack + React
2 Books
Get both SurviveJS - Webpack and SurviveJS - React for a single price! - #10
Experiential Learning Bundle
4 Books
This bundle provides all four volumes of the popular Experiential Learning Series at a savings of $20 over the price if purchased separately.
