update markdown files

Author: sebastian-ederer

README.md

@@ -1,13 +1,13 @@
-![CmdScale Project](https://github.com/cmdscale/.github/raw/main/profile/assets/CmdShield.svg)
+# CmdScale.EntityFrameworkCore.TimescaleDB
+
+![CmdScale Project](https://github.com/cmdscale/.github/raw/main/profile/assets/CmdShield.svg)
 [![Test Workflow](https://github.com/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB/actions/workflows/run-tests.yml/badge.svg)](https://github.com/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB/actions/workflows/run-tests.yml)
 [![codecov](https://codecov.io/gh/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB/graph/badge.svg?token=YP3YCJLQ41)](https://codecov.io/gh/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB)
 [![GitHub release (latest by date)](https://img.shields.io/github/v/tag/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB)](https://github.com/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB/tags)
 [![GitHub issues](https://img.shields.io/github/issues/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB)](https://github.com/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB/issues)
 [![GitHub license](https://img.shields.io/github/license/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB)](https://github.com/cmdscale/CmdScale.EntityFrameworkCore.TimescaleDB/blob/main/LICENSE)
 ![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
 
-# CmdScale.EntityFrameworkCore.TimescaleDB
-
 This repository provides the essential libraries and tooling to seamlessly integrate [TimescaleDB](https://www.timescale.com/), the leading open-source time-series database, with Entity Framework Core. It is designed to give you the full power of TimescaleDB's features, like hypertables and compression, directly within the familiar EF Core environment.
 
 - **CmdScale.EntityFrameworkCore.TimescaleDB**: The core runtime library. You include this in your project to enable TimescaleDB-specific features when configuring your `DbContext`.
@@ -48,10 +48,10 @@ Create and manage **TimescaleDB continuous aggregates** — automatically refres
 
 To get started, install the necessary packages from NuGet. For a typical project, you will need both.
 
-| Package | Description |
-|--------|-------------|
-| `CmdScale.EntityFrameworkCore.TimescaleDB` | Runtime support for EF Core + TimescaleDB |
-| `CmdScale.EntityFrameworkCore.TimescaleDB.Design` | Design-time support for EF Core tooling |
+| Package                                           | Description                               |
+| ------------------------------------------------- | ----------------------------------------- |
+| `CmdScale.EntityFrameworkCore.TimescaleDB`        | Runtime support for EF Core + TimescaleDB |
+| `CmdScale.EntityFrameworkCore.TimescaleDB.Design` | Design-time support for EF Core tooling   |
 
 ---
 
@@ -152,6 +152,7 @@ docker-compose up -d
 ### Resetting the Database Environment
 
 If you need to start with a completely fresh, empty database, you can stop the running container and permanently delete all of its data.
+
 > **Warning**: This command is destructive and will erase all tables and data stored in your local TimescaleDB instance.
 
 ```bash
@@ -168,10 +169,10 @@ This project uses a two-tier testing strategy to ensure code quality and correct
 
 ### Test Projects
 
-| Project | Purpose |
-|---------|---------|
-| `CmdScale.EntityFrameworkCore.TimescaleDB.Tests` | Unit tests using xUnit and Moq. Fast, isolated tests for differs, extractors, generators, and conventions. Also includes integration tests using Testcontainers. |
-| `CmdScale.EntityFrameworkCore.TimescaleDB.FunctionalTests` | EF Core specification tests validating end-to-end behavior against a real TimescaleDB instance. |
+| Project                                                    | Purpose                                                                                                                                                          |
+| ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `CmdScale.EntityFrameworkCore.TimescaleDB.Tests`           | Unit tests using xUnit and Moq. Fast, isolated tests for differs, extractors, generators, and conventions. Also includes integration tests using Testcontainers. |
+| `CmdScale.EntityFrameworkCore.TimescaleDB.FunctionalTests` | EF Core specification tests validating end-to-end behavior against a real TimescaleDB instance.                                                                  |
 
 ### Running Tests
 
@@ -282,7 +283,18 @@ Or, configure it in Visual Studio:
 2. Navigate to the `Package Sources` section.
 3. Click the '+' icon to add a new source, give it a name (e.g., "LocalCmdScale"), and set the path to your local feed folder.
 
----
+## 🔖 Release strategy
+
+Eftdb targets the latest .NET LTS release. Support follows a rolling two-version model:
+
+| Support Level    | Scope                      |
+| ---------------- | -------------------------- |
+| **Current LTS**  | New features and bug fixes |
+| **Previous LTS** | Critical bug fixes only    |
+
+**Example:** When .NET 12 (LTS) releases, it becomes the development target. .NET 10 receives only critical fixes, and .NET 8 support ends.
+
+This policy balances maintainability with ensuring the most widely-used .NET versions receive support.
 
 ## 📚 Resources
 
@@ -342,9 +354,7 @@ If you have questions, ideas, or need help getting started, feel free to [open a
 
 Thank you for contributing! 💜
 
----
-
-# 📄 License
+## 📄 License
 
 ```txt
 MIT License

benchmarks/Eftdb.Benchmarks/README.md

@@ -6,7 +6,7 @@ This project uses **BenchmarkDotNet** to measure the performance of high-through
 
 ## Prerequisites
 
-- .NET 10 SDK or later  
+- .NET 10 SDK or later
 - Docker
 
 ## Run the Benchmarks
@@ -25,7 +25,7 @@ You can run the benchmark project in one of two ways:
 
 Right-click on the `CmdScale.EntityFrameworkCore.TimescaleDB.Benchmarks` project and select:
 
-```
+```text
 Debug > Start Without Debugging
 ```
 

samples/Eftdb.Samples.CodeFirst/README.md

@@ -76,4 +76,3 @@ Connection string settings should match the configuration in your `docker-compos
 
 - [Entity Framework Core Documentation](https://learn.microsoft.com/en-us/ef/core/)
 - [TimescaleDB Documentation](https://docs.timescale.com/)
-

samples/Eftdb.Samples.DatabaseFirst/README.md

@@ -64,4 +64,3 @@ CmdScale.EntityFrameworkCore.TimescaleDB.Example.DataAccess.DbFirst/
 
 - [Entity Framework Core Documentation](https://learn.microsoft.com/en-us/ef/core/)
 - [TimescaleDB Documentation](https://docs.timescale.com/)
-

tests/Eftdb.Tests/STRYKER_README.md

@@ -32,7 +32,8 @@ dotnet stryker --mutate "**/HypertableDiffer.cs"
 ### 3. View Results
 
 After completion, the HTML report will be generated in:
-```
+
+```text
 StrykerOutput/reports/mutation-report.html
 ```
 
@@ -45,16 +46,19 @@ The `stryker-config.json` file is optimized for this project:
 ### Key Settings
 
 - **Projects Mutated:**
+
   - `CmdScale.EntityFrameworkCore.TimescaleDB` (main library)
   - `CmdScale.EntityFrameworkCore.TimescaleDB.Design` (design-time library)
 
 - **Test Project:**
+
   - `CmdScale.EntityFrameworkCore.TimescaleDB.Tests` ✅
   - **Excludes:** `CmdScale.EntityFrameworkCore.TimescaleDB.FunctionalTests` ❌
 
 - **Concurrency:** 8 parallel processes (adjust based on CPU cores)
 
 - **Thresholds:**
+
   - **High:** 80% (green) - Excellent mutation score
   - **Low:** 60% (orange) - Needs improvement
   - **Break:** 50% (red) - Build fails if below this
@@ -68,6 +72,7 @@ The `stryker-config.json` file is optimized for this project:
 ### Files Excluded from Mutation
 
 The following are automatically excluded:
+
 - `*.Designer.cs` files
 - `obj/` and `bin/` directories
 - `Migrations/` directories
@@ -82,7 +87,7 @@ The following are automatically excluded:
 
 ### Mutation Score
 
-```
+```text
 Mutation Score = (Killed Mutations / Total Mutations) × 100%
 ```
 
@@ -93,7 +98,7 @@ Mutation Score = (Killed Mutations / Total Mutations) × 100%
 
 ### Example Output
 
-```
+```text
 All files | 87.5% | 350/400 | 350 | 40 | 10 | 0
 ├── Differs | 92.3% | 120/130 | 120 | 8 | 2 | 0
 ├── Generators | 85.7% | 180/210 | 180 | 25 | 5 | 0
@@ -105,24 +110,29 @@ All files | 87.5% | 350/400 | 350 | 40 | 10 | 0
 ### Speed Up Mutation Testing
 
 1. **Use `--since` flag:**
+
    ```bash
    dotnet stryker --since
    ```
+
    Only mutates files changed since last commit.
 
 2. **Increase concurrency:**
+
    ```bash
    dotnet stryker --concurrency 16
    ```
 
 3. **Use baseline (after first run):**
+
    ```json
    "baseline": {
      "enabled": true
    }
    ```
 
 4. **Target specific files:**
+
    ```bash
    dotnet stryker --mutate "**/Differs/**"
    ```
@@ -144,27 +154,31 @@ If a file has a low mutation score (<60%), it usually means:
 ### Issue: Tests are too slow
 
 **Solution:** Increase `additional-timeout` in config:
+
 ```json
 "additional-timeout": 20000
 ```
 
 ### Issue: Too many mutations to process
 
 **Solution:** Use `--since` or target specific files:
+
 ```bash
 dotnet stryker --since --mutate "**/Differs/**"
 ```
 
 ### Issue: False positives on string mutations
 
 **Solution:** Already configured to ignore string mutations:
+
 ```json
 "ignore-mutations": ["string"]
 ```
 
 ### Issue: Integration tests timing out
 
 **Solution:** Already excluded via:
+
 ```json
 "test-case-filter": "Category!=Integration"
 ```