Added additional description of the library

Author: bastianeicher

Diff for: README.md

@@ -5,6 +5,10 @@
 [![API documentation](https://img.shields.io/badge/api-docs-orange.svg)](https://code-generation.nano-byte.net/)  
 A thin wrapper around the [Roslyn API](https://docs.microsoft.com/en-us/dotnet/csharp/roslyn-sdk/) to simplify generating C# code.
 
+This can be used to implement things like code generators for Swagger/OpenAPI Spec, ORMs, etc. using a type-safe interface rather than simple string templating.
+
+While you can use the Rosyln API directly, its immutable and thread-safe design can make using it somewhat verbose and cumbersome. This library provides a simpler (but also less flexible) wrapper.
+
 ## Usage
 
 Add a reference to the [`NanoByte.CodeGeneration`](https://www.nuget.org/packages/NanoByte.CodeGeneration/) NuGet package to your project. You can then generate a class like this:

Diff for: doc/main.md

@@ -1,5 +1,9 @@
 A thin wrapper around the [Roslyn API](https://docs.microsoft.com/en-us/dotnet/csharp/roslyn-sdk/) to simplify generating C# code.
 
+This can be used to implement things like code generators for Swagger/OpenAPI Spec, ORMs, etc. using a type-safe interface rather than simple string templating.
+
+While you can use the Rosyln API directly, its immutable and thread-safe design can make using it somewhat verbose and cumbersome. This library provides a simpler (but also less flexible) wrapper.
+
 [**GitHub repository**](https://github.com/nano-byte/code-generation)
 
 ## Usage