Enhance documentation for DbContext, DbSet, and IQueryable extensions with detailed remarks on functionality and usage

Author: Clifftech123

src/EfCoreKit.Core/Context/EfCoreKitDbContext.cs

@@ -7,6 +7,15 @@ namespace EfCoreKit.Core.Context;
 /// Base <see cref="DbContext"/> that provides automatic soft delete, audit trail,
 /// multi-tenancy, and bulk operation support.
 /// </summary>
+/// <remarks>
+/// This class inherits from <see cref="DbContext"/> — all standard EF Core features remain
+/// fully available. You can use LINQ queries, raw SQL (<c>Database.ExecuteSqlAsync</c>),
+/// change tracking, migrations, <c>DbSet&lt;T&gt;</c>, and any EF Core provider feature
+/// exactly as you would with a plain <see cref="DbContext"/>.
+///
+/// EfCoreKit only adds behaviour in the save pipeline (<c>SaveChangesAsync</c>) and
+/// through optional global query filters — it never restricts or hides native APIs.
+/// </remarks>
 /// <typeparam name="TContext">The derived context type.</typeparam>
 public abstract class EfCoreKitDbContext<TContext> : DbContext
     where TContext : DbContext

src/EfCoreKit.Core/Extensions/DbSetExtensions.cs

@@ -8,6 +8,12 @@ namespace EfCoreKit.Core.Extensions;
 /// <summary>
 /// Extension methods for <see cref="DbSet{T}"/> providing common query shortcuts.
 /// </summary>
+/// <remarks>
+/// These are additive convenience methods — all standard <see cref="DbSet{T}"/> and
+/// EF Core APIs (<c>Add</c>, <c>Attach</c>, <c>Entry</c>, <c>FromSqlRaw</c>,
+/// <c>ExecuteDeleteAsync</c>, <c>ExecuteUpdateAsync</c>, etc.) remain fully available
+/// and can be used alongside these helpers.
+/// </remarks>
 public static class DbSetExtensions
 {
     // ─── Single-entity lookups ────────────────────────────────────────

src/EfCoreKit.Core/Extensions/QueryableExtensions.cs

@@ -9,6 +9,12 @@ namespace EfCoreKit.Core.Extensions;
 /// Extension methods for <see cref="IQueryable{T}"/> providing pagination,
 /// conditional filtering, and dynamic ordering.
 /// </summary>
+/// <remarks>
+/// These are additive convenience methods — all standard LINQ and EF Core
+/// <see cref="IQueryable{T}"/> operators (<c>Where</c>, <c>Select</c>, <c>Include</c>,
+/// <c>GroupBy</c>, <c>Join</c>, etc.) continue to work and can be mixed freely
+/// with the helpers below.
+/// </remarks>
 public static class QueryableExtensions
 {
     /// <summary>