Elestriel / TaskbarTools

Grants the ability to set the Windows Taskbar to any opacity and colour desired.
MIT License
343 stars 29 forks source link

Refacto solution #14

Open aloisdg opened 7 years ago

aloisdg commented 7 years ago

Hello,

Some refacto.

What kind of code style to you want to use? Can you add a setting in the repo?

Thank you !

Elestriel commented 7 years ago

My style is fairly straightforward. Always use explicit typing (var is the devil), and in any code blocks, use squiggly brackets. This especially applies for one line if and else blocks.

I believe both of these significantly increase readability and reduce the possibility for confusion.

aloisdg commented 7 years ago

var is the devil

To quote Ilya Ryzhenkov:

Using var keyword can significantly improve your code, not just save you some typing. However, it may require discipline to apply good practices when using implicitly typed variables. Here is my list:

  • It is required to express variables of anonymous type. This is pretty obvious - you cannot declare local variable of anonymous type without using var.
  • It induces better naming for local variables. When you read local variable declaration with explicit type, you have more information at that moment and something like "IUnitTestElement current" makes sense. However, when this local variable is used later, you read "current" which takes some time to figure out the meaning. Using "var currentElement" makes it easier to read at any place.
  • It induces better API. When you let compiler deduce type from method return type or property type, you have to have good types in the first place. When you don't have explicit type in the initialization expression, you have to have best names for members.
  • It induces variable initialization. It is generally a good practice to initialize variable in the declaration, and compiler needs initializer to infer type for local variable declared with "var" keyword.
  • It removes code noise. There are a lot of cases, when implicitly typed local will reduce amount of text developer needs to read, or rather skip. Declaring local variable from new object expression or cast expression requires specifying type twice, if we don't use "var". With generics it can lead to a lot of otherwise redundant code. Another example would be iteration variable in foreach over Dictionary<TKey,TValue>. It doesn't require using directive. With var, you don't have explicit reference to type, as compiler infers type for you, so you don't need to import namespace when you need a temporary variable.

source

But If you don't like it I can change it.

any code blocks, use squiggly brackets. This especially applies for one line if and else blocks.

I find that less cluttered code is easier to read. Less cognitive load. Once again it is your code, your rules. 😄

Can you add a stylecop or a R# settings for the repo?