docs: Improve Readme.md for v1

Author: neomasterhub

Docs/readme/template-nuget.md

@@ -6,5 +6,6 @@
 {operators}
 {configuration}
 {testing}
+{demos}
 {limitations}
 {potential}

Docs/readme/template.md

@@ -8,5 +8,6 @@
 {operators}
 {configuration}
 {testing}
+{demos}
 {limitations}
 {potential}

Neomaster.JsonToLinq.ReadmeBuilder/Program.cs

@@ -16,6 +16,7 @@
   .InsertReadmeTemplate("operators")
   .InsertReadmeTemplate("configuration")
   .InsertReadmeTemplate("testing")
+  .InsertReadmeTemplate("demos")
   .InsertReadmeTemplate("limitations")
   .InsertReadmeTemplate("potential")
   ;
@@ -29,6 +30,7 @@
   .InsertReadmeTemplate("operators")
   .InsertReadmeTemplate("configuration")
   .InsertReadmeTemplate("testing")
+  .InsertReadmeTemplate("demos")
   .InsertReadmeTemplate("limitations")
   .InsertReadmeTemplate("potential")
   .Replace(@"`\|`", "`|`")

Neomaster.JsonToLinq/Neomaster.JsonToLinq.csproj

@@ -9,7 +9,7 @@
     <NoWarn>$(NoWarn);IDE0079</NoWarn>
     <PackageId>JsonToLinq</PackageId>
     <PackageIcon>logo.png</PackageIcon>
-    <Version>1.0.0-rc917</Version>
+    <Version>1.0.0-rc920</Version>
     <Authors>Neomaster</Authors>
     <Company>Neomaster</Company>
     <Copyright>Copyright © 2026 Neomaster</Copyright>

readme-nuget.md

@@ -302,6 +302,40 @@ Unit tests cover:
 
 Full unit test coverage will be relevant after the library has been used in real projects.
 
+## 🔬 Demos and Experiments<a name="demos"/>
+
+This repository includes the [JsonToLinq.Demo][demo-project] project with **working examples**.
+You are welcome to submit a PR with your own examples, bug reports, or new features.
+**To describe a filter, use the following notation:**
+
+### 🔤 Filter Notation
+
+#### Syntax
+```
+expr = logic[expr(, expr)*]
+```
+- `expr` - a single rule or a combination of rules
+- `logic` - an operator used to combine multiple rules, e.g. `&&`, `&`, `||`, `|`, or a custom one
+
+#### Examples
+1. `&&[x = null]`
+1. `&&[a < 0, b > 0]`
+1. `&&[x = null, ||[a < 0, b > 0]]`
+
+### 💻 Demo Project
+
+This project provides examples of working with **EF Core** and a **PostgreSQL database**.
+
+🧪 A real database is used instead of in-memory storage, ensuring clean and realistic experiments.
+
+➕ You can add your own examples with other databases or ORMs via a PR.
+
+▶️ Before running the demos, select the first menu item, **Prepare Data**, to apply migrations and populate the tables with test data.
+
+[demo-project]: https://github.com/neomasterhub/Neomaster.JsonToLinq/tree/master/Neomaster.JsonToLinq.Demo
+
+![Demo project](https://github.com/neomasterhub/Neomaster.JsonToLinq/blob/master/Docs/img/demo-project.png?raw=true "Demo project")
+
 ## 🚧 Limitations<a name="limitations"/>
 
 1. **No IDE syntax highlighting for JSON filter arguments in LINQ methods**

readme.md

@@ -318,6 +318,40 @@ Unit tests cover:
 
 Full unit test coverage will be relevant after the library has been used in real projects.
 
+## 🔬 Demos and Experiments<a name="demos"/>
+
+This repository includes the [JsonToLinq.Demo][demo-project] project with **working examples**.
+You are welcome to submit a PR with your own examples, bug reports, or new features.
+**To describe a filter, use the following notation:**
+
+### 🔤 Filter Notation
+
+#### Syntax
+```
+expr = logic[expr(, expr)*]
+```
+- `expr` - a single rule or a combination of rules
+- `logic` - an operator used to combine multiple rules, e.g. `&&`, `&`, `||`, `|`, or a custom one
+
+#### Examples
+1. `&&[x = null]`
+1. `&&[a < 0, b > 0]`
+1. `&&[x = null, ||[a < 0, b > 0]]`
+
+### 💻 Demo Project
+
+This project provides examples of working with **EF Core** and a **PostgreSQL database**.
+
+🧪 A real database is used instead of in-memory storage, ensuring clean and realistic experiments.
+
+➕ You can add your own examples with other databases or ORMs via a PR.
+
+▶️ Before running the demos, select the first menu item, **Prepare Data**, to apply migrations and populate the tables with test data.
+
+[demo-project]: https://github.com/neomasterhub/Neomaster.JsonToLinq/tree/master/Neomaster.JsonToLinq.Demo
+
+![Demo project](https://github.com/neomasterhub/Neomaster.JsonToLinq/blob/master/Docs/img/demo-project.png?raw=true "Demo project")
+
 ## 🚧 Limitations<a name="limitations"/>
 
 1. **No IDE syntax highlighting for JSON filter arguments in LINQ methods**