Posts

Web API Scaffolding

Image
 Key points What is API ? What is Scaffolding ? How to do it ? Best Practices of API What is api ? Application Programming Interface An API is a set of definitions and protocols for building and integrating application software. APIs let your product or service communicate with other products and services without having to know how they’re implemented. This can simplify app development, saving time and money. What is Scaffolding ? Scaffolding is a code generation framework Scaffolding, as used in computing, refers to one of two techniques: The first is a code generation technique related to database access in some model–view–controller frameworks; the second is a project generation technique supported by various tools. There are two options for scaffolding MVC; Minimal and Full. If you select Minimal, only the NuGet packages and references for ASP.NET MVC are added to your project. If you select the Full option, the Minimal dependencies are added, as well as the required content fi...

How to create API documentation

Image
 How to create API documentation ? Basic information about api documentation, how to create one, how to make it useful ? What is document ? Document that describes handling, functionality and architecture of a technical product or a product under development or use. The intended recipient for product technical documentation is both the end user as well as the administrator / service or technician. Why do we need document? The presence of documentation helps keep track of all aspects of an application and it improves on the quality of a software product. Its main focuses are development, maintenance and knowledge transfer to other developers. Documentation help ensure consent and expectations. Any professional is always looking for ways to improve, or a better approach, a more successful course of treatment, or fresh ideas to tackle ongoing problems. Documentation is crucial in achieving these measures.  Who should write document? Or How to write Document ? focus on the refer...

New C#9 keywords ‘and’ ‘or’ ‘not’

Image
C#9 language introduces new controversial keywords: and  keyword: Conjunctive patterns. Require both patterns to match or  keyword: Disjunctive patterns. Require either pattern to match not  keyword: Negative patterns. Require that a pattern doesn’t match In this article we’ll explore how some common expressions can be rewritten with these keywords and how they improve the pattern matching syntax. We’ll question also the motivations beside these keywords and their impact on code complexity. (and or not) vs. (&& || !) With those new keywords it is now possible to write C# code similar to what we have with VB or F#. For example: 1 2 3 4 5        public static bool IsLetterOrSeparator1 ( char c ) = >          c is ( > = 'a' and < = 'z' ) or ( > = 'A' and < = 'Z' ) or '.' or ',' ;          public static bool IsLetterOrSeparato...