Update README.md

Author: a-gubskiy

README.md

@@ -3,12 +3,10 @@
 [![NuGet version](https://img.shields.io/nuget/v/BitzArt.XDoc.svg)](https://www.nuget.org/packages/BitzArt.XDoc/)
 [![NuGet downloads](https://img.shields.io/nuget/dt/BitzArt.XDoc.svg)](https://www.nuget.org/packages/BitzArt.XDoc/)
 
-# Overview
+A lightweight and efficient tool for parsing and managing C# XML documentation comments.
 
-A lightweight and efficient tool for parsing, and managing C# XML documentation comments.
 
-
-### BitzArt.XDoc
+# BitzArt.XDoc
 
 BitzArt.XDoc is a lightweight .NET library for parsing and accessing XML documentation comments from your C# code. It provides an intuitive API to retrieve documentation for:
 * Types/classes
@@ -28,7 +26,7 @@ var typeDocs = xdoc.Get(typeof(MyType));
 var propertyDocs = xDoc.Get(typeof(MyType).GetProperty(nameof(MyType.PropertyOne)));
 ```
 
-### BitzArt.XDoc.PlainText
+# BitzArt.XDoc.PlainText
 
 BitzArt.XDoc.PlainText is an extension package for BitzArt.XDoc that enables rendering XML documentation 
 comments into plain text.
@@ -47,60 +45,55 @@ var propertyDescrption = xDoc.Get(typeof(MyType).GetProperty(nameof(MyType.Prope
 
 ```
 
-
-### BitzArt.XDoc.EntityFrameworkCore
-
-#### Features:
+# BitzArt.XDoc.EntityFrameworkCore
 
 BitzArt.XDoc.EntityFrameworkCore is an extension library that bridges XML documentation comments from C# 
 code to Entity Framework Core database objects.
 
+
 Example 1: Configure comments for all entities in your DbContext
 
 ```csharp
 using BitzArt.XDoc;
-using Xdoc.Renderer.PlaintText;
-using BitzArt.XDoc.EntityFrameworkCore
-...
-
-services.AddScoped<EntitiesCommentConfigurator>();
-
-...
 
 public class MyDbContext : DbContext 
 {
-    private readonly EntitiesCommentConfigurator _commentConfigurator;
-    
-    public MyDbContext(DbContextOptions options, EntitiesCommentConfigurator commentConfigurator) : base(options)
-    {
-        _commentConfigurator = commentConfigurator;
-    }
-    
     protected override void OnModelCreating(ModelBuilder modelBuilder)
     {
         base.OnModelCreating(modelBuilder);
 
         // Configure comments for all entities
-        _commentConfigurator.ConfigureComments(modelBuilder);
+        modelBuilder.ConfigureComments(new XDoc());
     }
 }
 ```
 
-
 Example 2: Configure comments for specific properties using Fluent API
 
-
 ```csharp
 using BitzArt.XDoc;
-using Xdoc.Renderer.PlaintText;
-using BitzArt.XDoc.EntityFrameworkCore
 
 ...
 
 protected override void OnModelCreating(ModelBuilder modelBuilder)
 {
     modelBuilder.Entity<Customer>()
         .Property(c => c.Name)
-        .MapPropertyComment<string, Customer>(c => c.Name);
+        .HasComment<string, Customer>(c => c.Name);
 }
 ```
+
+## Recommendations
+Each XDoc instance maintains its own cache of parsed documentation in a `ConcurrentDictionary<Assembly, AssemblyDocumentation>`. Using multiple instances unnecessarily duplicates this data in memory
+
+If your application provides documentation-related services (like API documentation generation), maintaining a single pre-loaded XDoc instance can significantly improve response times.
+
+### Possible approaches
+
+#### Dependency Injection (Recommended)
+Register XDoc as a singleton in your application's dependency injection container.
+
+#### Factory
+Create a factory that provides access to a shared XDoc instance:
+
+By following these recommendations, you can ensure that XML documentation is parsed only once per assembly, maximizing performance and minimizing resource usage in your application.