Libraries

• Awesome dotnet - List of most popular libraries
• Awesome dotnet core - List of most popular libraries for Dot Net Core

Technical features

• Logging - Implement as simple as possible. Collect logs by using popular library like NLog, lo4net and others. Review logs periodically or send daily/week reports. Consider send email for unhandled exceptions.
• Validation - each application has different types of validation. In ideal implementation validation in backend should be reused in frontend. Validation is one of the application’s core functionalities. Define validation layer and reuse on all layers. Think about localisation of validation errors. Helpful questions: “How to display localised validation error at frontend for input field which returned by backend (backend has multiple layers and data containers can be different between layers (DTO, Entities, Business layer, Data layer, etc.)?”
• Localization - many applications requires two or more languages. One of the problematic areas is to implement localisation for multiple layers/tiers. For example application has two projects: Web API back end + SPA frontend. In ideal situation backend and frontend are using the same source of translations and current localisation is synchronized between them.
• Multi tenancy
• Web API. REST API vs RPC - Clean and simple implementation of Web Api (doesn’t related to Net framework) is’t easy task. Choose between two types of APIs. There is a lot of buzz around REST API, but also there are a lot of popular services which have RPC based API. One of the biggest disadvantages of REST API that it bad fits actions (ex. “Generate report action”, “Move item”, “Copy item”).
  • Understanding RPC Vs REST For HTTP APIs
  • Do you really know why you prefer REST over RPC?
  • Best Practices for Designing a Pragmatic RESTful API
  • https://developer.todoist.com/sync/v7/
• Open API + Swagger CodeGen - Generate Api specification based on Open API specification. Generate code based on specification. For example generate protocol based on Web API and generate TypeScript/JavaScript client code based on protocol.
  • https://www.openapis.org/
  • https://swagger.io/swagger-codegen/
  • https://medium.com/slack-developer-blog/standard-practice-slack-web-openapi-spec-daaad18c7f8
• Code contracts - Additional info http://deviq.com/guard-clause/
• Code interception. AOP - https://msdn.microsoft.com/en-us/library/dn178466(v=pandp.30).aspx
• Parsing - Implement parser for complex cases instead of regex usage.
  • https://tomassetti.me/guide-parsing-algorithms-terminology/
  • https://tomassetti.me/antlr-mega-tutorial/
  • https://theantlrguy.atlassian.net/wiki/spaces/ANTLR3/pages/2687210/Quick+Starter+on+Parser+Grammars+-+No+Past+Experience+Required
• Share assembly version across projects. Store assebly info in common file.
  • Dot Net Core. https://stackoverflow.com/a/42183749
  • Net Framework. https://stackoverflow.com/a/62637 GlobalAssemblyInfo.cs

Code quality (code review)

• Code comments - write comments for classes, methods, etc. Generate documentation.
• Code documentation - write documentation (ex. README.MD files) about technical features “How log something”, “How valdate data”. Best practice is to reuse already implemented technical features, but without proper documentation it’s hard to find out how some feature implemented. Write documentation with examples and link code implementation if possible. Describe used frameworks, libraries, patterns, etc.
• How code will be tested - think how code will be tested this can help identify potential problems like calls static classes, dependencies created inside, etc.
• In which cases code won’t work - think which parameters, states, execution results, etc. are not properly covered by code. Most simple example that method doesn’t check parameter for null before use it.

Guidelines

• Abstract DateTime - implement DateTimeProvider for better testing
• New is glue - https://ardalis.com/new-is-glue
• Do not use static methods and properties - http://deviq.com/static-cling/
• Designing with interfaces - https://www.javaworld.com/article/2076841/core-java/designing-with-interfaces.amp.html
• Code control flow
• Reduce code nesting - https://refactoring.guru/replace-nested-conditional-with-guard-clauses
• С# immutable parameters - Do not change parameters inside method body. Functional programming.
• Code cyclomatic complexity
• Return empty collection instead of null - https://stackoverflow.com/a/1970001
• Find code examples in big projects at github
• Classes naming
  • Names of Generic Type Parameters
  • Naming Classes - How to avoid calling everything a <WhatEver>Manager?
  • Often used class name suffixes

Solution and projects structure

• Architecting Modern Web Applications with ASP.NET Core and Azure eBook + Sample ASP.NET Core reference application
• Use namespaces over projects
  • https://lostechies.com/chadmyers/2008/07/16/project-anti-pattern-many-projects-in-a-visual-studio-solution-file/
  • https://codurance.com/2015/03/23/multiple-projects-in-visual-studio/
  • https://ayende.com/blog/3158/the-two-project-solution
  • http://geekswithblogs.net/FrostRed/archive/2008/10/03/125628.aspx
  • http://codebetter.com/jeremymiller/2008/09/30/separate-assemblies-loose-coupling/
  • http://www.hanselman.com/blog/AssemblyFiefdomsWhatsTheRightNumberOfAssembliesLibraries.aspx
  • https://msdn.microsoft.com/en-us/library/ee658109.aspx

Patterns

• Repository + Unit of Work + Specification
  • Specification pattern
  • Implementing the Repository and Unit of Work Patterns in an ASP.NET MVC Application
• Dependency injection. Aggregate services

Misc

• Write good Git commits
  • Convetional commits style
  • Useful Tips for writing better Git commit messages
• Write changelog files in Keepchangelog style
• Set product/assemblies versions in Semantic versioning style

Debug

• Debug/Trace Network for Net Core app Debugging CoreFX on Windows
  • Explanation:
    • Net Core use EventSource for events writing
    • There is common NetEventSource used for Net related events NetEventSource
    • Particular name of NetEventSource configured inside particular assembly NetEventSource.Http.cs
  • Instruction:
    • Download PerfView.exe
    • Download files Scripts
    • Run CMD as Administrator
    • Execute net_startlog.cmd
    • Do some actions which send HTTP requests
    • Execute net_stoplog.cmd
    • net_000001.etl created
    • From CMD (ran as Administrator) run “PerfView.exe /InMemoryCircularBuffer”
    • PerfView open file net_000001.etl
• Debug/Trace Network for Full Framework app How to: Configure Network Tracing
• Debug/Trace WCF for Full Framework
  • Configuring Tracing
  • Tracing and Message Logging